INTRODUCTION 

This manual gives complete descriptions of all the publicly 
available features of UNIX. It provides neither a general ovei 
view (see "The UNIX Time-sharing System" for that) nor details c 
the implementation of the system (which remain to be disclosed). 

Within the area it surveys, this manual attempts to be as com- 
plete and timely as possible. A conscious decision was made to 
describe each program in exactly the state it was in at the time 
its manual section was prepared. In particular, the desire to 
describe sonething as it should be, not as it is, was resisted. 
Inevitably, this means that many sections will soon be out of 
date. (The rate of change of the system is so great that a 
dismayingly large number of early sections had to be modified 
while the rest were being written. The unbounded effort required 
to stay up-to-date is best indicated by the fact that several of 
the programs described were written specifically to aid in 
preparation of this manual!) 

This manual is divided into seven sections: 

I. Commands 

II. System calls 

III. Subroutines 

IV. Special files 

V. File formats 

VI. User-maintained programs 

VII. Miscellaneous 

Commands are programs intended to be invoked directly by the 
user, in contradistinction to subroutines, which are intended tb 
be called by the user's programs. Commands generally reside i^ 
directory /bin (for bin ary programs). This directory is searched 
automatically by the command line interpreter. Some programs 
classified as commands are located elsewhere; this fact is indi- 
cated in the appropriate sections. 

System calls are entries into the UNIX supervisor. In assembly 
language , they are coded with the use of the opcode sys , a 
synonym for the trap instruction. 

The special files section discusses the characteristics it each 
system "file" which actually refers to an l/O device. 

The file formats section documents the structure of particular 
kinds of files; for example, the form of the output of the loader 
and assembler is given. Excluded are files used by oly one ccxn- 
mand, for example the assembler's intermediate files 

User-maintained programs are not considered part ofthe UNIX sys- 
tem, and the principal reason for listing them is o indicate 
their existence without necessarily giving a complte 
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description. The author should be consulted for information. 
The miscellaneous section gathers odds and ends. 

Each section consists of a number of independent entries of a 
page or so each. The name of the entry is in the upper right 
corner of its pages, its preparation date in the upper left. 
Entries within each section are alphabetized. It was thought 
better to avoid page numbers, since it is hoped that the manual 
will be updated frequently. 

All entries have a cotimon format. 

The name section repeats the entry name and gives a very 
short description of its purpose. 

The synopsis summarizes the use of the program being 
described, A few conventions are used, particularly in the 
Commands section: 

Underlined words are considered literals, and are typed 
just as they appear. 

Square brackets ( [] ) around an argument indicate that the 
argument is optional. When an argument is given as 
name , it always refers to a file name. 

Ellipses ... are used to show that the previous 
argument-prototype may be repeated. 

A final convertion is used by the commands themselves. 

-^ ft »f 

An argument beginning with a minus sign - is often tak- 
en to mean some sort of flag argument even if it appears 
in a position where a file name could appear. Therefore, 
it is unwise to have files whose names begin with "-" . 

The description section discusses in detail the subject at 
hand. 

The files section gives the names of files which are built 
into the program, 

A see also section gives pointers to related ^information, 

A diagnostics section discusses the diagnostics that may be 
produced. This section tends to be as terse as the diagnos- 
tics themselves. 

The bugs section gives known bugs and sometimes deficien- 
cies. Occasionally also the suggested fix is described. 

The owner section gives the name of the person or persons to 
be consulted in case of difficulty. The rule has been that 
the last one to modify something owns it, so the owner is 
not necessarily the author. The owner's initials stand for: 
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ken 


K, Thompson 


dmr 


D. M. Ritchie 


jfo 


J. F, Ossanna 


rhm 


R, Morris 



These three-character names also happen to be UNIX user 
id's, so messages may be transmitted by the mai l command or, 

4 ^ ^ 1^ A ^t^r^i^/r^^f9A^ A at 1^^ "^^^ ^^f^ 4 *<i V. « * v.« w> 4 A* ^ 

J.J. i«.it«^ Cl^kAVAJ. ^ ooS^ ju j.v^t^v^ Ova •^'^1 *^^ wZ^X uS m 

At the beginning of this document is a table of contents, organ- 
ized by section and alphabetically within each section. There is 
also a permuted index derived from the table of contents. Within 
each index entrv- the title of the writeu" to which it refers is 
followed by the appropriate section number in parentheses. This 
fact is important because there is considerable name duplication 
among the sections, arising principally from commands which exist 
only to exercise a particular system call. 

This manual was prepared using the UNIX text editor ed and the 
formatting paragram roff . 
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TABLE OF CONTENTS 

I. COMMANDS 

ar archive (combine) files 

as assembler 

b coinpile B program 

bas .• BASIC dialect 

bed convert ASCII to BCD 

boot reboot system 

cat , concatenate (or print) files 

^Iim.JL ....................... v^ixail^v^ w\jd. I\.a.li*^ ^^o. JL ^w wv-zj. jr 

check check consistency of file system 

chmod change access mode of files 

chown , f change owner of files 

cmp compare file contents 

cp copy file 

date get date and time of day 

db symbol ic debugger 

dbppt write binary paper tape 

dc desk calculator 

df find free disk space 

dsw delete files interactively 

dtf format DECtape 

du find disk usage 

ed text editor 

find find file with given name 

for compile Fortran program 

form generate form letter 

hup hang up typewriter 

Ibppt read binary paper tape 

Id * link editor ( loader ) 

In link to file 

Is list contents of directory 

mail send mail to another user 

mesg permit or deny messages 

mkdir create directory 

mkfs initialize file system 

mount mount detachable file system 

mv move or rename file 

nm , print namelist 

od octal dump of file 

pr print file with headings 

rew rewind DECtape 

rkd d\amp disk to tape 

rkf format RK disk 

rkl load di sk from tape 

rm. rem.ove (delete ) file 

rmdir remove ( delete ) directory 

roff run off (format) text 

sdate adjust date and time 

sh command interpreter 

Stat get file status 

strip remove symbols, relocation bits 

su become super-user 
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sum sum file 

tap man'ipulate DECtape 

tm get time information 

tty find name of terminal 

type print file on IBM 2741 

umount dismount removable file system 

un find undefined symbols 

v?c .ai»i»»iiiiiiiiii»iiii»»ii ce t ( English ) word count 

who who is on the system 

write write to another user 



II, SYSTEM CALLS 

break set program break 

cemt catch EMT traps 

chdir change working directory 

chmod change mode of file 

chown change owner of file 

close close open file 

creat create file 

exec , , execute program file 

exit terminate execution 

fork create new process 

fstat status of open file 

getuid get user ID 

gtty . get typewriter mode 

ilgins ,,,,.,,,,.,,, catch illegal instruction t] 

intr . catch or inhibit interrupts 

link link to file 

mkdir create directory 

mount mount file system 

open open file 

quit catch or inhibit quits 

read read file 

rele release processor 

seek move read or write pointer 

setuid set user ID 

smdate set date m.odified of file 

Stat get file status 

stime set system time 

stty set mode of typewriter 

tell find read or write pointer 

time , get time of year 

umount dismount file system 

unlink remove (delete) file 

wait wait for process 

write write file 



III. SUBROUTINES 

atof convert ASCII to floating 

atoi convert ASCII to integer 

ctime convert time to ASCII 

exp exponential function 
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fptrap floating-point simulator 

ftoa , convert floating to ASCII 

get get character 

itoa . convert integer to ASCII 

log logarithm base e 

mesg print string on typewriter 

ptime print time 

putc , write character or word 

sin , ,, sine, cosine 

switch transfer depending on value 



mem core memory as file 

ppt punched paper tape 

rfO RF disk file 

rkO RK disk file 

tapO, . . . , tap? DECtape file 

tty , console typewriter 

ttyO, .... ttyS remote typewriter 



V. FILE FORMATS 

a , out assembler and loader output 

archive archive file 

bppt binary paper tape format 

core core image file 

directory , directory format 

file system file system format 

passwd password file 

uids map names to user ID's 

utmp logged-in user information 



VI. USER MAINTAINED PROGRAMS 

basic DEC supplied BASIC 

bj , the game of black jack 

cal print calendar 

chess . the game of chess 

das disassembler 

dli load DEC binary paper tapes 

dpt read DEC ASCII paper tapes 

moo , the game of MOO 

sort sort a file 

ttt the game of tic-tac-toe 



VII. MISCELLANEOUS 

as2 , assembler's pass 2 

ascii map of ASCII 

ba B assembler 

be B compiler 
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bilib ,....,.. B interpreter library 

bproc boot procedure 

brti ,brt2 B start and finish 

f1,f2,f3,f4 Fortran compiler passes 

glob , argument expander 

init initializer process 

kbd map of TTY 37 keyboard 

liba , standard assembly-language library 

libb standard B library 

1 ■< b*^ standard Pcr'*~ran lib'*^a''^^' 

lOCrin 1nrroii+- -_-.--_, - 1 orrrr i n rr (->n adH 1 orrrrincr O'f'F -l-Vid c^ra-t-csm 

msh mini Shell 

suf tab rof f ' s suffix table 

tabs set tab stops on typewriter 
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chmod ( I ) : change 

sdated ) : 

mail(l): send mail to 

V73r i t e ' "^ ^ • V7^ n ■*- ca •*- /^ 

ar(l) : 
archive( V) ; 

glob(VTI): 

dpt(Vl): read DEC 

bcd( I ) : convert 

atof (III): 

atoi(lll): 

ascii(VIl) 

ctime(lll): convert 

convert floating to 
; convert integer to 



convert 

convert 

map of 

time to 



itoa(lll) 



liba(VII) 



a.out(V): 

as( I ) : 
ba(VIl) : B 
as 2 ( VII} : 
standard 



ba(VII) 

bc(VII) 

bilib(VII) 

libb(VII): standard 

b( I ) : compile 

brt1 ,brt2(Vll) : 

log(lll): logarithm 



basic(VI ) 



bas(l): 
DEC supplied 



bcd(l): convert ASCII to 



su(l): 



bppt ( V ) : 

dbppt ( I ) : write 

Ibppt(l): read 

dli(Vl) : load DEC 

remove symbols, relocation 



access mode of files 
adjust date and time 
another user 
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a,out(V): assembler and loader output 

archive (combine) files 

archive file 

archive(V); archive file 

argument exi^ander 

ar(l): archive (combine) files 

ASCII paper tapes 

ASCII to BCD 

ASCII to floating 

ASCII to integer 

ASCII 

ASCII 

ASCII... ftoa(lll). 

ASCII 

ascii(VIl): map of ASCII 

as(l): assembler 

assembler and loader output 

assembler 

assembler 

assembler's pass 2 

assembly-language library 

as2ivii): assembler's pass 2 

atof (III): convert ASCII to floating 

atoi(lll): convert ASCII to integer 

B assembler 

B compiler 

B interpreter library 

B library 

B program 

B start and finish 

base e 

bas(l): BASIC dialect 

BASIC dialect 

BASIC 

basic(Vl): DEC supplied BASIC 

ba(Vll): B assembler 

BCD 

bcd(l): convert ASCII to BCD 

be (VII): B compiler 

become super-user 

b(l): compile B program 

bilib(VIl): B interpreter library 

binary paper tape format 

binary paper tape 

binary paper tape 

binary paper tapes 

bits. . .strip( l) : 

bj(Vl): the game of black jack 
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bj(Vl): the game of 
bproc(VIl) : 



break(ll): set program 



dc( I ) : desk 
cal(Vl): print 

cemt(Il) : 

ilgins( II ) : 

intr(Il) : 

quit(ll) : 



chmod (I ) : 

chmod (II): 

chown ( I I ) : 

chown ( I ) : 

chdir(l): 

chdir(ll) : 

putc(lll): write 

get(lll): get 



check ( I ) : 
chess (VI): the game of 



black jack 

boot proced\are 

boot(l): reboot system 

bppt(V): binary paper tape format 

bproc(VIl): boot procedure 

break 

break(ll): set program break 

brt1 ,brt2(VIl) : B start and finish 

calculator 

calendar 

cal(Vl): print calendar 

catch EMT traps 

catch illegal instruction trap 

catch or inhibit interrupts 

catch or inhibit quits 

cat(l): concatenate (or print) files 

cemt(Il): catch EMT traps 

change access mode of files 

change mode of file 

change owner of file 

change owner of files 

change working directory 

change working directory 

character or word ^ 

character 

chdir(l): change working directory 

chdir(ll): change working directory 

check consistency of file system. 



close(ll) 



ar(l) : archive 

sh(l): 

cmp ( I ) : 

b(l): 

f or ( I ) : 

f1 ,f2,f3,f4(VIl): Fortran 

bc(VIl): B 

cat(l) : 

che ck ( I ) : che ck 

tty(lV) : 

ls(l): list 

cmp(l): compare file 

bcd(l) : 

atof (III): 

atoi(lll): 

ftoa(lll) : 

itoa(lll) : 

ctime(lll) : 
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check consistency of file system 

the game of chess 
change access mode of files 

change mode of file 
change owner of files 

change owner of file 

file 



check 

chess 

chess (VI ) 

chmod ( I ) : 

chmod (II) 

chown ( I ) : 

chown (II) 

close open 

close(ll): close open file 

cmp(l): compare file contents 

(combine) files 

command interpreter 

compare file contents 

compile B program 

compile Fortran program 

compiler passes 

compiler 

concatenate (or print) files 

consistency of file system 

console typewriter 

contents of directory 

contents 

convert ASCII to 

ASCII to 

ASCII to 

floating 

integer 



convert 
convert 
convert 
convert 
convert 



BCD 

floating 
integer 
to ASCII 
to ASCII 



time to ASCII 
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cp(l): 
core(V) : 
mem (IV) : 

sin(lll) : sine, 
wc(l): get (English) word 

mkdir( I ) : 
mkdir(Il) : 
creat(ll) : 

fork (II) : 



dated ): get 

sdate(l): adjust 

smdate(ll): set 

date (I): get date and time of 



db(l): symbolic 

dpt(Vl): read 

dli(Vl): load 

basic(Vl): 

tapO,. ..,tap7(lV): 

dtf(I;: format 

rew(l ) : rewind 

tap(l): manipulate 

rmdir(l}: remove 

rm(l) : remove 

dsw(i ) : 

unl ink ( I I ) : remove 

mesg(l): permit or 

switch(lll): transfer 

dc(l): 

mount ( I ) : mount 

bas(l): BASIC 

directory (V) : 

chdir(l): change working 

chdir(ll): change working 

ls(l): list contents of 

mkdir(l): create 

mkdir(ll): create 

rmdir(l): remove (delete) 

das(Vl): 

rfO(lV): RF 

rkO(IV): RK 

rkl(l): load 

df (I) : find free 

rkd( I) : dump 

du(l): find 

rkf(l): format RK 



copy file 

core image file 

core memory as file 

core(V): core image 

cosine 

count 

cp(l): 

create 

create 

create 

create 



file 



copy file 

directory 

directory 

file 

new process 



creat(ll): create file 

ctimevIII;; convert tiine to ASCII 

das(Vl): disassembler 

date and time of day 

date and time 

date modified of file 

date(l): get date and time of day 

day 

db(l): symbolic debugger 

dbppt(l): write binary paper tape 

dc(l): desk calculator 

debugger 

DEC ASCII paper tapes 

DEC binary paper tapes 

DEC supplied BASIC 

DECtape file 

DEC tape 

DECtape 

DECtape 

(delete) directory 

(delete) file 

delete files interactively 

(delete) file 

deny messages 

depending on value 

desk calculator 

detachable file system 

df(l); find free disk space 

dialect 

directory format 

directory 

directory 

directory 

directory 

directory 

directory 

directory(V) : directory format 

disassembler 

disk file 

disk file 

disk from tape 

disk space 

disk to tape 

disk usage 

disk 
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uinount(ll) : 
umountd ) : 



rKQ [X ) t 
odd ) : octal 



log( III ) : 



ld(l) 
ed( I) 
X og ar i t. run 



link 

•l-pv-t- 



cemt(ll) : catch 
wc ( I ) : get 



exit (II) 



exec(Il) : 
terminate 



glob ( VI I ) : argument 

exp(lll): 

cmp(l) : compare 

typed): print 

stat(l): get 

stat(ll): get 

file system (V ) : 

check consistency of 

mkfsl'l); initialize 

mount ( I ) : mount detachable 

mount ( II): mount 

umount ( I ) : dismount removable 

umount(ll): dismount 

find(l): find 

pr(l): print 

archive(V): archive 

chmod(ll): change mode of 

chown(ll): change owner of 

close ( II): close open 

core(V): core image 

cp(l): copy 

create II): create 

exec{ll): execute program 

fstat(ll): status of open 

link(Il) : link to 

Ind): link to 

core memory as 

move or rename 



mem(IV) : 

mv(l) : 

odd) 



octal dump of 

open d I ) : open 

passwd(V): password 

read(ll) : read 

rf 0(IV) : RF disk 

rkO(lV): RK disk 

rm(l): remove (delete) 



dismount file system 

dismount removable file system 

dli(Vl): load DEC binary paper tapes 

dpt(Vl): read DEC ASCII paper tapes 

dsw(l): delete files interactively 

dtf(l): format DECtape 

du(l): find disk usage 

dvimp disk to tape 

dump of file 

ed(l): text editor 

editor (loader) 

editor 

e 

EMT traps 

(English) word count 

exec(ll): execute program file 

execute progreim file 

execution 

exit(Il): terminate execution 

expander 

exp(lll): exponential function 

exponential function 

file contents 

file on IBM 2741 

file status 

file status 

file system format 

file system. ., check( I } : 

file systen: 

file system 

file system 

file system 

file system 

file system(v): file system format 

file with given name 

file with headings 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 

file 
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dsw(l): delete 

ar(l): archive (combine) 

concatenate (or print) 

change access mode of 

chown ( I ) : change owner of 

set date modified of 

sort(Vl): sort a 

sum ( I ) : sum 

tapO, ... .tap? (IV) 

unlink(ll5: remove 



: DECtape 
(delete) 
du(l): 
find(l): 


df (I) : 

tty(l): 

tell(ll): 

un(l): 



brt1 ,brt2(vii) : B start and 

ftoa(lll): convert 

atof(lll): convert ASCII to 

fptrap(lll) : 

form(l): generate 
dtf(l): 
rkf ( I ) : 
rof f (l) : run off 
: binary paper tape 
5X1 ectory ( V ) : directory 
file system(V): file system 

f1 ,f2,f3,f4(VIl): 

libf(VIl): standard 

for(l): ccsnpile 



bppt(V) 

direci 



df(l): find 


rkl(l): load disk 


exp(lll): exponential 


bj(Vl): the 


chess (VI): the 


moo(Vl): the 


ttt(Vl): the 


form(I): 


aet(lll) : 


dated ): 


wc ( I ) : 


stat(l) : 


Stat (II): 


tm(l): 


time(ll): 


gtty(ll): 


getuid(ll) : 



files interactively 

files 

files. , .cat(l) : 

files. . .chmod( l) : 

files 

file. , .smdate(ll) : 

file 

file 

file 

file 

find disk usage 

find file with given name 

find free disk space 

find name of terminal 

find read or write pointer 

find undefined symbols 

find(l): find file with given name 

finish 

floating to ASCII 

floating 

floating-point simulator 

for(l): compile Fortran program 

fork(Il): create new process ■ 

form letter 

format DECtape 

format RK disk 

(format) text 

format 

format 

format 

form(l): generate form letter 

Fortran compiler passes 

Fortran library 

Fortran program 

fptrap(IIl): floating-point simulator 

free disk space 

from tape 

fstat(ll): status of open file 

ftoa(lll): convert floating to ASCII 
function 

f 1 ,f2 ,f 3,f4(vil) : Fortran ccmpiler passes 
game of black jack 
game of chess 
game of MOO 
game of tic-tac-toe 
generate form letter 
get character 
get date and time of day 
get (English) word count 
get file status 
get file status 
get time information 
get time of year 
get typewriter mode 
get user ID 
get (I II): get character 
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find(l): find'file with 



pr(l): print 



hup( I ) : , 
file with 



type 1,1 I : print fxxe on 

getuid(II): get user 

setuid(ll): set user 

uids(V) : map names to user 



J1_J f TT \ . 



core(V) : core 

tm(l) : get time 

utmp(V): logged-in user 

intr(ll): catch or 

quit ( II): catch or 

mkfs(l): 

init(VIl) • 

ilgins(ll): catch illegal 

i toad II): convert 

atoi(lll): convert ASCII to 

dsw(l): delete files 

bilib(VII): B 

sh(l): ccmmand 

intr(II): catch or inhibit 



bj(Vl): the game of black 
kbd(VIl): map of TTY 37 



f orm( I ) : generate form 
library. . . 



bilib(VIl): B interpreter 

standard assembly-language 

libb(VIl): standard B 

libf(VIl): standard Fortran 

ld(I): 

link(ll): 

ln(l): 

ls(l): 

dli(Vl): 

rkl(l): 

a.out(V): assembler and 

ld(l): link editor 

log(lll): 

utmp(V) : 

logout (VII): logging on and 



process 



getuid(ll): get user ID 

given neime 

glob(VIl): argument expander 

gtty(ll): get typewriter mode 

hang up typewriter 

headings 

hup(l): hang up typewriter 

IBM 2741 

ID 

ID 

id's 

ilgins(ll): catch illegal instruction trap 
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image^ file 

information 

information 

inhibit interrupts 

inhibit quits 

initialize file system 

initializer process 

init(Vll): initializer 

instruction trap 

integer to ASCII 

integer 

interactively 

interpreter library 

interpreter 

interrupts 

intr(ll): catch or inhibit 

itoa(lll): convej^t integer 

jack 

kbd(VIl) : 

keyboard 

Ibppt (I ) : 

ld(l): link editor (loader) 

letter 

liba(VIl): 

libb(VIl): 

libf (VII): 

library 

library. ..liba(VIl): 

library 

library 

link editor (loader) 

link to file 

link to file 

link(ll): link to file 

list contents of directory 

ln(l): link to file 

load DEC binary paper tapes 

load disk from tape 

loader output 

(loader) 

logarithm base e 

logged-in user information 

logging off the system. ., login. 



interrupts 
to ASCII 



map of TTY 37 keyboard 
read binary paper tape 



standard assembly-language 
standard B library 
standard Fortran library 
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login, logout(VIl): 

logging off the system. , , 
the system. . , login , 

mail(l): send 

tap(l): 

uxus V V / : 

-.^^A -i ttTTT\. 

CIO '-XX \ V X X / ; 

kbd(VIl): 
mem(lV): core 



mesg(l): permit or deny 
msh(VII): 



chmod(Il): change 

chmod(l): change access 

stty(ll): set 

gtty(ll): get typewriter 

smdate(ll): set date 

moo(Vl): the game of 

mount ( I ) : 

luOUIlt. \ X X y ; 



mv(l) : 
seek(ll) : 



tty(l): find 
find(l): find file with given 

nm ( I ) : pr int 

uids(V): map 

fork ( II): create 

od ( I ) : 

roff{l): run 

close(ll): close 

fstat(ll): status of 

Open ( II ) : 

cat(l): concatenate 

assembler and loader 

chown ( I I ) : change 

chown(l): change 

bppt(V): binary 

dbppt(l): write binary 

Ibppt (I ) : read binary 

ppt ( IV ) : punched 



logging on and logging off the system 

log(lll): logarithm base e 

login, logout(Vll): logging on and 

logout(VIl): logging on and logging off 

ls(l): list contents of directory 

mail to another user 

mail(l): send mail to another user 

manipulate DECtape 

It lap lictiuos i^Kj uoci J-*-/ o 






map of TTY 37 keyboard 

mem(iv): core memory as file 

memory as file 

mesg(l): permit or deny messages 

mesg(lll): print string on typewriter 

messages 

mini Shell 

mkdir(l): create directoz;y 

mkdir(Il): create directory 

mkfs(l): initialize file system 

mode of file 

mode of files 

mode of typewriter 

mode 

modified of file 

MOO 

rr\r\^( UT ) • the CTSTfe of MOO 

mount detachable file system 

mount fxxe systeiTi 

mount(l): mount detachable file system 
mount ( II): mount file system 

move or rename file 

move read or write pointer 

msh(VIl): mini Shell 

mv(l): move or rename file 

name of terminal 

name 

namelist 

names to user ID's 

new process 

nm(l): print namelist. 

octal dump of file 

od(l): octal dump of file 

off ( format ) text 

open file 

open file 

open file 

open(ll): open file 

(or print) files 

out put . . . a . out ( V ) : 

owner of file 

owner of files 

paper tape format 

paper tape 

paper tape 

paper tape 
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dli(Vl): load DEC binary 

dpt(Vl): read DEC ASCII 

as2(VIl): assembler's 

Fortran compiler 

passwd( V) : 

mesg( I ) : 

seek(ll): move read or write 

tell^Il); find read or write 

cal(Vl): 

type ( I ) : 

pr(l): 

cat(l): concatenate (or 

nm(l): 

mesgClII ) : 

ptime( III) : 

bproc(VIl): boot 

fork(ll): create new 

init(Vll): initializer 

rele(ll): release 

wait (II): wait for 

break(ll) : set 

exec(ll): execute 

b( I ) : com.pile B 

f or ( T ) : compile Fortran 

ppt(IV): 



quit(ll): catch 



or inhibit 

Ibppt(l) 

dpt(Vl) 

read(ll) 

seek(ll): move 

tell(ll): find 

boot ( I ) : 
rele(ll) : 



strip(l): remove symbols, 

ttyO,...,tty5(lV): 

Limount ( I ) : dismount 

rmdir( l) : 

rm(l): 

unlink (II) : 

stripd ) : 

mv( I ) : move or 

rew(l ) : 
rfO(lV): 

rkO(lV): 
rkf(l): format 



paper tapes 

pajSer tapes 

pass 2 

passes. ..f1 ,f2,f3,f4(VIl) : 

passwd(v): password file 

password file 

permit or deny messages 

pointer 

c ,• ^ — 

ppt(iv)? punched paper tape 

pr(l): print file with headings 

print calendar 

print file on IBM 2741 

print file with headings 

print) files 

print namelist 

print string on typewriter 

print time 

procedure 

process 

process 

processor 

process 

program break 

program file 

program 

program 

ptime(lll): print time 

punched paper tape 

putc(lll): write character or word 

quit(ll): catch or inhibit quits 

quits 

read binary paper tape 

read DEC ASCII paper tapes 

read file 

read or write pointer 

read or write pointer 

read(ll):" read file 

reboot system 

release processor 

rele(Il): release processor 

relocation bits 

remote typewriter 

removable file system 

remove (delete) directory 

file 

file 

relocation bits 



remove 
rem.Qve 
remove 
rename 
rew(l ) 
rewind 
RF disk 
rfO(lV) 
RK disk 
RK disk 
rkd ( I ) : 



(delete) 
(delete) 
symbols, 
file 

rewind DECtape 
DECtape 

file 
RF disk file 

file 

dump disk to tape 
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suftab(VIl): 
roff(l) : 



mail( I) : 
smdate(ll) j 

_i. J / -r T \ 

a I- i-y V X JL ; ; 

breaJcdl): 

stiine(ll) : 

tabs (VII): 

setuid(ll) : 

msh(Vll): mini 



fptrap(IIl): floating-point 

sin(lll) : 



sort (VI) : 

df(l): find free disk 

liba(vil) : 

libb(VIl) : 

libf(vil): 

brtl ,brt2(vil): b 



fstat(ll): 
stat(l): get file 

stat(ll): get file 

tabs (VI I) : set tab 
mesg(lll): print 



suftab(Vll): roff's 



sum( I) : 

su(l): become 
basic(Vl): DEC 

db(l): 

strip(l): remove 

un(l): find undefined 

file system(V): file 

stime(ll): set 

boot(l): reboot 

check consistency of file 



cosine 

date modified 



of file 



rkf(l): format RK disk 

rkl(l): load disk from tape 

rkO(lV): RK disk file 

rmdir(l): remove (delete) directory 

rm(l): remove (delete) file 

roff(l): run off (format) text 

roff's suffix table 

run oft (format) text 

sdate(l): adjust date and time 

seek(II): move read or write pointer 

send mail to another user 

set date m.odified of file 

set mode, of typewriter 

set program break 

set system time 

set tab stops on typewriter 

set user ID 

setuid(ll): set user ID 

Shell 

sh(l): cCTnmand interpreter 

simulator 

sine, cosine 

sin(lll): sine, 

smdate(ll): se1 

sort a file 

sort (VI): sort a file 

space 

standard assembly-language library 

standard B library 

standard Fortran library 

start and finish 

stat(l): get file status 

Stat (II): get file status 

status of open file 

Status 

status 

stime(ll): set system time 

stops on typewriter 

string on typewriter 

strip(l): remove symbols, relocation bits 

stty(ll): set mode of typewriter 

suffix table 

suftab(VIl): roff's suffix table 

su(l): become super-user 

sum file 

sum(l) : sum file 

super-user 

supplied BASIC 

switch(III): transfer depending on value 

symbolic debugger 

symbols, relocation bits 

symbols 

system format 

system time 

system 

system. . . check( I ) : 
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and logging off the 
mkfs(l): initialize file 
mount detachable 
mount (II): mount 
dismount removable 
: dismount 



file 
file 
file 
file 
file 
who is on the 
tabs (VII): set 
suftab(VIl): roff's suffix 



umount (ll) 



who [ I ; 



dbppt ( I ) 



bppt(V) : binary 






wxix-e cindiry pdptsr 

Ibppt ( I ) : read binary paper 

ppt(lV): punched' paper 

rkd(l): dump disk to 

rkl(l): load disk from 

load DEC binary paper 

dpt(Vl): read DEC ASCII paper 



tty(l): find name of 

exit (II) : 

ed(l): 

off (format) 

: the game of 

tm(l): get 

get date and 

time (II) : get 

ctime(lll): Convert 



roff(l): run 
ttt(vi) 



dated 



ptime(lll): print 

sdate(l): adjust date and 

stime(Il): set system 

switch(lll): 

catch illegal instruction 

cemt(ll): catch EMT 

kbd(VIl): map of 



gtty(ll): get 

hup( I) : hang up 

mesg(lll): print string on 

stty(ll): set mode of 

tabs(VII): set tab stops on 

tty(iv): console 

ttyO, .. . ,tty5(lV) : remote 



.login, logout(VIl) 
.mount( I) : 
, umount ( I ) : 

file system format 



logging on 



un( l) : find 



system, 

system 

system. 

system 

system, 

system 

system(V) 

system 

tab stops on typewriter 

table 

tabs(VIl): set tab stops on typewriter 

tape format 

tape 

tape 

tape 

tape 

tape 

tapes. , .dli(Vl) : 

tapes 

tap(l): manipulate DECtape 

tapO, . . . ,tap7(lV) : DECtape file 

tell(ll): find read or write pointer 

terminal 

terminate execution 

text editor 

text 

tic-tac-toe 

time information 

time of day 

time of year 

time to ASCII 

time (II): get time of year 

time 

time 

time 

tm(l): get time information 

transfer depending on value 

trap. , .ilgins( II) : 

traps 

ttt(Vl): the game of tic-tac-toe 

TTY 37 keyboard 

tty(l): find name of terminal 

tty(lV): console typewriter 

ttyO, . . , , tty5(lV) : remote typewriter 

type(l): print file on IBM 2741 

typewriter mode 

typewriter 

typewriter 

typewriter 

typewriter 

typewriter 

typewriter 

uids(v): map names to user ID's 

umount(l): dismount removable file system 

umount (II): dismount file system 

undefined symbols 
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dud): find disk 

getuid(Il) : get 

setuid(ll): set 

uids(V): map names to 

utmp ( V ) ! 1 ogge d-i n 

mail(l): send mail to another 



write(I): write tu 



transfer depending on 
wait (II): 



who ( I ) : 



find(l) : find file 

pr(l): print file 

wc(l): get (English) 

putc(lll): write character or 

chdir(l): change 

chdir(ll): change 

dbppt(l): 

putc(lll) : 

seek(ll): move read or 

tell(ll): find read or 

wr i t e ( I ) : 



time ( II ) 



get time Oj. 
as2(vil): assembler's pass 
type(I): print file on IBM 
kbd(VIl): map of TTY 



un(l): find undefined symbols 
unlink(ll): remove (delete) file 
usage 
user ID 

ID 

id's 

information 



user 
user 
user 
user 



utmp(V): logged— in user information 

value. . .switch( III) : 

wait for process 

wait (II): wait for process 

wc(l): get (English) word count 

who is on the system 

who(l): who is on the system 

with given name 

with headings 

word count 

word 

working directory 

working directory 

write binary paper tape 

write character or word 

write pointer 

write pointer 

write to another user 

write(l): write to another user 

year 

2 

2741 

37 keyboard 
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AR (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



ar — archive 

ar key afile name, ... 

ar maintains groups of files combined into a sin- 
gle archive file, its main use is to create and 
update library files as used by the loader. It 
can be used, though, for any similar purpose, 

key is one character from the set drtux . option- 
ally concatenated with v, afile is the archive 
file. The names are constituent files in the 
archive file. The meanings of the key characters 
are: 

d means delete the named files from the archive 
file. 

r means replace the named files in the archive 
file. If the archive file does not exist, r will 
create it. If the named files are not in the 
archive file, they are appended. 

t prints a table of contents of the archive file. 
If no names are given, all files in the archive 
are tabled. If names are given, only those files 
are tabled, 

u is similar to r except that only those files 
that have been modified are replaced. If no 
names are given, all files in the archive that 
have been modified will be replaced by the modi- 
fied version, 

X will extract the named files. If no names are 
given, all files in the archive are extracted. 
In neither case does x alter the archive file, 

V means verbose. Under the verbose option, ar 
gives a file-by-file description of the making of 
a new archive file from the old archive and the 
constituent files. The following abbreviations 

are used: 



FILES 

SEE ALSO 

DIAGNOSTICS 



c copy 
a append 
d delete 
r replace 
X extract 

/tmp/vtma, vtmb 

Id 



temporary 



I^Bad usage", "afile — ^not in archive format"^^ 
cannot open temp file", "name — cannot open , 



^name — phase error", "name — cannot create", 
^no archive file ,^ cannot create archive file , 
name — not found , 

BUGS Option 1 (table with more information) should be 

implemented. 

There should be a way to specify the placement of 

— ••— " ».^-.v- J.H ^11 U4. V. 1 1 J. V C * lk,MJL i CllUXy J IC is 

placed at the end, 
OWNER ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



as — assembler 



as name 



— 1 ... 

as assembles the concatenation of name 



1 1 



as 



is based on the DEC-provided assembler ' PAL-1 1R 
[references] , although it was coded locally. 
Therefore, only the differences will be recorded. 

Character changes are; 



for 


use 


e 


« 


# 


$ 


• 

» 


/ 



In as, the character ; is a logical new line; 
several operations may appear on one line if 
separated by ";", Several new expression opera- 
tors have been provided: 



\> 

\< 
» 

V 
% 

! 



right shift (logical) 

left shift 

multiplication 

division 

remainder (no longer means "register ) 

one's complement 

pcurentheses for grouping 

result has value of left, type of right 



For examgle location 

ten "o'^, ; another way to denote register 2 

"a'ro". 



(relocatable) can be writ- 
is 



All of the preceding operators are binary; if a 
left^ogerand is missing, it is taken to be 0, 
The " ! operator adds its left operand to the 
one's ccxnplement of its right operand. 

There is a conditional assembly operation code 
different from that of PAL-1 1R (whose condition- 
als are not provided): 

.if expression 

» • . 
, end if 

If the expression evaluates to non-zero jj the sec- 
tion of code between the ".if" and the .endif" 
is assembled; otherwise it is ignored, ",if"s 
may be nested. 

Temporary labels like those introduced by Knuth 
[reference] may be employed. A temporary label 
is defined as follows: 
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n; 

where n is a digit ... 9. Sjjmbols of the form 
"nf" refer to the first label n: following the 
use of the s^bol; those of the form "nb" refer 
to the last n: " . The same "n" may be used many- 
times. Labels of this form are less taxing both 
on the imagination of the programmer and on the 

The PAL-11R opcodes ".eot" and ".end" are redun- 
dant and are omitted. 

The symbols 

rO ... r5 

sp 
pc 
ac 

mul -^ 
Ish 
ash , 
nor. 
csw 



are gredefined with appropriate values. The s^- 
bol csw" refers to the console switches. .. 
is the relocation constant and is added to each 
relocatable symbol; normally it is 40000(8); it 
may be changed to assemble a section of code at a 
location different from that in which it will be 
executed. 

It i9 illegal to assign a value to "," less than 
its current value. 

The new opcode "sys" is used to specify system 
calls. Names for system calls are predefined. 
See the section on system calls for their names. 

Strings of characters may be assembled in a way 
more convenient than PAL-11's ".ascii operation 
(which is, therefore, omitted). Strings are 
included between the string quotes "<" and ">": 

<here is a string> 

Escape se<5uences exist to enter non graphic and 
other difficult characters. These sequences are 
also effective in single and double character 
constants introduced by single (') and double ( ) 
quotes respectively. 
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use 


for 


\n 


newline (012) 


\o 


NULL (000) 


\> 


> 


\t 


TAB foil ) 


W 


\ 



FILES 



SEE ALSO 
DIAGNOSTICS 



The Dxnarjr output or tne assemoxer is pxacea on 
the file a. out" in the current directory, a. out 
also contains the symbol table from the assembly 
and relocation bits. The output of the assembler 
is executable immediately if the assembly was 
error-free and if there were no unresolved exter- 
nal references. The link editor Id may be used 
to ccMnbine several assembly outputs and resolve 
global symbols. 

The multiple location counter feature of PAL11R 
is not supported. 

The assembler does not produce a listing of the 
source program. This is not a serious drawback; 
the debugger db discussed below is sufficiently 
powerful to render a printed octal translation of 
the source unnecessary. 



/etc/as2 
a , tmp 1 
a,tmp2 
a,tmp3 
a, out 



pass 2 of the assembler 

temporary 

temporary 

temporaury 

object 



Id,- nm, sh, un, db, a. out (format of output) 

When an input file cannot be read, its name fol- 
lowed by a question mark is typed and assembly 
ceases. 



When syntactic or semantic errors occur, a 
single-character diagnostic is typed out together 
with the line number and the file name in which 
it occurred. Errors in pass 1 cause cancellation 
of pass 2, The possible errors are: 

) parentheses error 

] parentheses error 

* Indirection ("*") used illegally 

A error in Address 

B Branch instruction has too remote an ad- 
dress 

E error in Expression 

F error in local ("f" or "b") type symbol 

G Garbage (unknown) character 

M Multiply defined symbol as label 

Odd — word quantity assembled at odd 
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address 
P Phase error — "," different in pass 2 from 

pass 1 value 
R Relocation error 

U Undefined symbol 

X syntax error 

BUGS Symbol table overflow is not checked, 

OWNER dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



B — language 

sh re /usr/b/rc name 

B is a language suitable for system programming. 
It is described is a separate publication B 
reference manual. 






pile the program narae,b into the executable file 
a, out. It involves running the B compiler, the B 
assembler, the assembler and the link editor. 
The process leaves the files name.i and name.s in 
the current directory, 

ncurae,b, name.i, name,5, 

/etc/be, /etc/ba, /etc/brt1, /etc/brt2, 
/etc/bilib, /etc/libb,a, B reference manual, 

see B reference manual 

There should be a B command. 

ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



has — basic 



bas [file] 



bas is a dialect of basic. If a file argument is 
provided, the file is used for input before the 
console is read. 



I^ao a/^/^Aw^4 



14v\^^ f^-^ 4-Vfc< 






statement 
integer statement 

Integer numbered statements (known as Internal 
statements) are storfed for later execution. They 
are stored in sorted ascending order, Non- 
nximbered statements are immediately executed. 
The result of an immediate expression statement 
(that does not have '=' as its highest operator) 
is printed. 

Statements have the following syntax: ( expr is 
short for expression) 

expr 

The expression is executed for its side 
effects (assignment or function call) or 
for printing as described above. 

done 

Return to system level. 

draw expr expr expr 

draw is used to draw on a 611-type storage 
scope through a TSP-1 plotter interface. 
The coordinates of the scope face are zero 
to one in both the x and y directions. 
(Zero, zero being the lower left corner.) 
The expressions are evaluated and designat- 
ed X, Y, and Z. A line is drawn from the 
previous X, Y to the new X, Y. If Z is 
non-zero, the line is visible, otherwise 
the. line is invisible. 

for name = expr expr statement 
for name = expr expr 

• • • 

next 

The for statement repetatively executes a 
statement (first form) or a group of state- 
ments (second form) under control of a 
named variable. The variable takes on the 
value of the first expression, then is 
incremented by one on each loop, not to 
exceed the value of the second expression. 



mx^^ 


M«- -^.l- A>*.<'HM^ 


A 0. 


A^Ay^.« V A^ 


4-r 


•I-Va 


A^«^«"Aac? 4 A«^ 


X lie; 
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goto expr 

The expression is evaluated, truncated to 
an integer and execution goes to the 
corresponding integer nuitibereu statraent. 
If executed from immediate mode, the inter- 
nal statements are compiled first. 

if expr statement 

evaluates to non-zero. 

li st [expr [expr]] 

list is used to print out the stored inter- 
nal statements. If no arguments are given, 
all internal statements are printed. If 
one argument -is given, only that internal 
statement is listed. If two arguments are 
given, all internal statements inclusively 
between the arguments are printed, 

print expr 

The expression is evaluated and printed. 

return expr 

The expression is evaluated and the result 
is passed back as the value of a function 
call. 

run 

The internal statements are compiled. The 
symbol table is re-initialized. The random 
number generator is re-set. Control is 
passed to the lowest numbered internal 
statement. 

Expressions have the following syntax: 

name 

A name is used to specify a variable. 
Names are composed of a letter ('a' - ' z' ) 
followed by letters and digits. The first 
four characters of a name are significant. 

nxamber 

A nianber is used to represent a constant 
value. A number is composed of digits, at 
most one decimal point ('.') and possibly a 
scale factor of the form e digits or e- 
digits. 

i expr 1 

Parentheses are used to alter normal order 
of evaluation, 

expr op expr 

Common functions of two arguments are 
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abbreviated by the two arguments separated 
by an operator denoting the function, A 
complete list of operators is given below. 

expr 1 [expr [j. expr ...]] J. 

Functions of an arbitrary nvmber of argu- 
ments can be called by an expression fol- 
lowed by the arguments in parentheses 
separated by ccanmas. The expression evalu- 
ates to the line number of the entry of the 
function in the internally stored state- 
ments. This causes the internal statements 
to be compiled. if the expression evalu- 
ates negative, an built in function is 
called. The list of builtin functions 
appears below. 

name £ expr [j_ expr ,.,] }_ 

Arrays are not yet implemented. 

The following is the list of operators: 

= is the assicsTimerit Q'^erator- The left 
operand must be a name or an array element. 
The result is the right operand. Assign- 
ment binds right to left, all other opera- 
tors bind left to right. 



& (logical and) has result zero if either 
of its arguments are zero. It has result 
one if both its arguments are non-zero, J_ 
(logical or) has result zero if both of its 
arguments are zero. It has result one if ' 
either of its arguments are non-zero. 

The relational operators (< less than, <= 
less than or equal, > greater than, >= 
greater than or equal, == equal to, <> not 
equal to) return one if their arguments are 
in the specified relation. They return 
zero otherwise. Relational operators at 
the same level extend as follows: a>B>c is 
the same as a>b&b>c. 

+ - 

Add and subtract, 

* / 

Multiply and divide. 

Exponeniation. 
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FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



The following is a list of builtin functions: 

arg 

Arg(i) is the value of the ith actual 
pareuneter on the current level of function 
call. 



exp 



Kxnfxl is the exDonential function of x. 



log 



Log(x) is the logarithm bas e of x. 



sin 



Sin(x) is the sine of x (radians). 



cos 



Cos(x) is the cosine of x (radians). 



atn 



Atn(x) is the arctangent of x, (Not imple- 
mented, ) 

rnd 

Rnd() is a uniformly distributed random 
number between zero and one, 

expr 

Expr() is the only form of pr9gram input, 
A line is read from the input and evaluated 
as an expression. The resultant value is 
returned, 

int 

Int(x) returns x truncated to an integer, 

/tmp/t>tma, btmb ,,, temporary 



Syntax errors cause the incorrect line to be 
typed with an underscore where the parse failed. 
All other diagnostics are self explanatory. 

Arrays [] are not yet implemented. In general, 
program sizes, recursion, etc are not checked, 
and cause trouble. 

ken 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



bed — binary coded decimal conversion 

bed [ string ] 

bed will convert a string into GECOS card code. 
If no argument string is provided, bed will read 
a line and convert it. 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



boot — reboot system 

/etc/boot 

boot logically a CCTtunand, and is kept in /etc 
only to lessen the probability of its being in- 
voked by accident or from curiosity. It reboots 
the system by jumping to the read-only memory, 



ri i eV K(-k/^4- 



ir\irr\rrr ar 



boot procedure 



Should obviously not be executable by the general 
user. Also, it should reboot in a more direct 
manner. The mechanism invoked by jumping to the 
ROM loader is sensitive to the contents of the 
console switches, which makes the whole procedure 
even more dangerous. 



RaL 



unci, cnaii juiiipj.n<j 'Cu one kum, oooi^ six/uxi-i simu- 
late the ROM action with 173700 in the switches. 
In this manner, It may be used when the switches 
are not set, and even in installation without a 
ROM, 



OWNER 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



cat — concatenate and print 
cat file^ ... 

cat reads each file in sequence and writes it on 
the standard output stream. Thus: 

cat file 
is about the easiest way to print a file. Also: 

£M flle1 file2 >file3 

is about the easiest way to concatenate files. 

If no input file is given cat reads from the 
standard input file. 



pr, cp 

none; if a file cannot be found it is ignored, 

ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



chdir — change working directory 

chdir directory 

directory becomes the new working directory. 

Because a new process is created to execute each 
command, chdir would be ineffective if it were 
written as a normal command. It is therefore 
recognized and executed by the Shell. 



FILES 


— 


SEE ALSO 


sh 


DIAGNOSTICS 


? 


BUGS 


— 


OWNER 


ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 



Check — file system consistency check 

check [ filesystem [ blockno^ ... ] ] 

c^ecJ< will examine a file system, build a bit map 
of used blocks, and compare this bit map against 
the bit map maintained on the file system. If 
the file system is not specified, a check of both 
/ ^>^x/ j.i.v duvj / «cv/ ij%.w is pertorinea, uucput in- 
cludes the number of files on the file system, 
the number of these that are 'large', the number 
of used blocks, and the number of free blocks. 

/dev/rfO, /dev/rkO 

find 

Diagnostics are produced for blocks missing, 
duplicated, and bad block addresses. Diagnostics 
are also produced for block numbers passed as 
parameters, in each case, the block number, 
i-number, and block class (i = inode, x indirect, 
f free) is printed. 

The checking process is two pass in nature. If 
checking is done on an active file system, ex- 
traneous diagnostics may occur. 

The swap space on the RF file system is not ac- 
counted for and will therefore show up as 'miss- 
ing'. 



OWNER 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



chmod — change mode 



chmod octal file 



1 *•• 

The octal mode replaces the mode of each of the 
files. The mode is constructed from the OR of 
the following modes: 



02 read for non-owner 
04 write for owner 
10 read for owner 
20 executable 
40 set-UID 

Only the owner of a file may change its mode. 



FILES 


— 


SEE ALSO 


Stat, Is 


DIAGNOSTICS 


? 


BUGS 


— 


OWNER 


ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



chDwn — change owner 

chown owner file. ... 

owner becomes the new owner of the files. The 
owner may be either a decimal UID or a name found 
in /etc/uids. 

Only the owner of a file is allowed to change the 
owner. It is illegal to change the owner of a 
file with the set-user-ID mode. 



FILES 


/etc/uids 


SEE ALSO 


Stat 


DIAGNOSTICS 


? 


BUGS 


— 


OWNER 


ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



cmp — compare two files 
cmp file^ f^l®2 

The two files are compared for identical con- 
tents. Discrepancies are noted by giving the 
offset and the differing words. 



Messages are given for inability to open either 
argument, premature EOF on either argument, and 
incorrect usage. 

If the two files differ in length by one byte, 
the extra byte does not enter into the compari- 
son. 



OWNER 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



cp — copy 

eg file^i ^^^®12 ^^^®21 ^^^®22 ••' 

Files are taken in pairs; the first is opened for 
reading, the second created mode 17, Then the 
first is copied into the second. 



cat , pr 

Error returns are checked at every system call, 
and appropriate diagnostics are produced. 

The second file should be created in the mode of 
the first, 

A directory convention as used in mv should ba 
adopted to cp . 



OWNER 



ken, dmr 
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NAME 



SYNOPSIS 


date 


DESCRIPTION 


The c 


FILES 


— 


0£«£i rXLfO^ 




DIAGNOSTICS 





BUGS 





OWNER 


c3mr 



date — print the date 

date 

The current date is printed to the second. 
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NAME 

SYNOPSIS 

DESCRIPTION 



db — debug 

db [ core [ naraelist ] ] 

Unlike many debugging packages (including DEC's 
ODT, on which db is loosely based) db is not 

to examine; instead it examines files. Typical- 
ly, the file will be either a core image produced 
after a fault or the binary output of the' assem- 
bler. Core is the file being debugged; if omit- 
ted core is assumed. namelist is a file con- 
taining a symbol table. If it is omitted, a. out 
is the default. If no appropriate name list file 
can be found, db can still be used but some of 
its symbolic facilities become unavailable. 

The format for most db requests is an address 
followed by a one character command. 

Addresses are expressions built up as follows: 

1 , A name has the value assigned to it when 
the input file was assembled. It may be 
relocatable or not depending on the use of 
the name during the assembly, 

2, An octal number is an absolute quantity 
with the appropriate value. 

3, An octal number immediately followed by "r" 
is a relocatable quantity with the ap- 
propriate value. 

4, The symbol "." indicates the current 
pointer of db. The current pointer is set 
by many db requests. 

5, Expressions separated by "+" or " " (blauik) 
are expressions with value equal to the sum 
of the components. At most one of the com- 
ponents may be relocatable, 

6, Expressions separated by "-" form an ex- 
pression with value equal to the difference 
to the components. If the right component 
is relocatable, the left component must be 
relocatable, 

7, Expressions are evaluated left to right. 
Names for registers are built in: 

rO . , , r5 

sp 
pc 
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ac 
mq 

These may be examined. Their values are deduced 
from the contents of the stack in a core image 
file. They are meaningless in a file that is not 
a core image. 

If no address is given for a command, the current 
address (also specified by ".") is assumed. In 
general, "," points to the last word or byte 
printed by db. 

There are db commands for examining locations 
interpreted as octal numbers, machine instruc- 
tions, ASCII characters, and addresses. For 
numbers and characters,, either bytes or words may 
be examined. The following commands are used to 
examine the specified file, 

/ The addressed word is printed in octal. 

\ The addressed byte is printed in octal. 

The addressed word is printed as two ASCII 
characters, 

' The addressed byte is printed as an ASCII 
character, 

* The addressed word is multiplied by 2 , then 
printed in octal (used with B programs, 
whose addresses are word addresses), 

? The addressed word is interpreted as a 

machine instruction and a symbolic form of 
the instruction, including symbolic ad- 
dresses, is printed. Usually, the result 
will appear exactly as it was written in 
the source program, 

& The addressed word is interpreted as a sym- 
bolic address and is printed as the name of 
the symbol whose value is closest to the 
addressed word, possibly followed by a 
signed offset, 

<nl> (i, e, , the character "new line") This 
command advances the current location 
counter "," and prints the resulting loca- 
tion in the mode last specified by one of 
the above requests, 

"" This character decrements "," and prints 
the resulting location in the mode last 
selected one of the above requests. It is 
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a converse to <nl>. 

It is illegal for the word-oriented commands to 
have odd addresses. The incrementing and decre- 
menting of "." done by the <nl> and requests is 
by one or two depending on whether the last com- 
mand was word or byte oriented. 

The address portion of any of the above commands 
may be followed by a comma and then by an expres- 
sion. In this case that number of sequential 
words or bjftes specified by the expression is 
printed, ," is advanced so that it points at 
the last thing printed. 

There are two commands to interpret the value of 
expressions, 

= When preceded by an expression, the value 
of the expression is typed in octal. When 
not preceded by an expression, the value of 
"," is indicated. This command does not 
change the value of ".**. 

t An attempt is made to print the given ex- 
pression as a symbolic address. If the 
expression is relocatable, that symbol is 
found whose value is nearest that of the 
expression, and the symbol is typed, fol- 
lowed by a sign and the appropriate offset. 
If the value of the expression is absolute, 
a symbol with exactly the indicated value 
is sought and printed if found; if no 
matching symbol is discovered, the octal 
value of the expression is given, 

. The following command may be used to patch the 
file being debugged, 

! This command must be preceded by an expres- 
sion. The value of the expression is 
stored at the location addressed by the 
current value of ",", The opcodes do not 
appear in the symbol table, so the user 
must assemble them by hand. 

The following command is used after a fault has 
caused a core image file to be produced, 

$ causes the contents of the general regis- 
ters and several other registers to be 
printed both in octal and symbolic format. 
The values are as they were at the t.ime of 
the fault. 
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The only way to exit from db is to generate an 
end of file on the typewriter (EOT character). 



SEE ALSO as; core for format of core image. 

DIAGNOSTICS "File not found" ^ if the first argument cannot be 

read' otherv?ise "? 

BUGS Really, db should know about relocation bits, 

floating point operations, and PDP11/45 instruc- 
tions. 

OWNER drar 
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DBPPT (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



dbppt — dianp binary paper tape 
dbppt name [ output ] 

^^PP^ produces binary paper tape in UNIX standard 
fuiiiiat, which includes checksums and a zero- 
suppression feature. File name is dumped; if the 
output argument is not given, output goes to 
/dev/ppt. 

/dev/ppt 

J-fappt to reload the tapes, bppt for binary paper 
tape format. 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



dc — desk calculator 
dc 

dc is an arbitrary precision integer arithmetic 
package. The overall structure of dc is a stack- 
ing (reverse Polish) calculator. The following 
constructions are recognized by the calculator: 

number 

The value of the number is pushed on the 
stack. If the number starts with a zero, it 
is taken to be octal, otherwise it is decimal. 

The top two values on the stack are added (+), 
, subtracted (-), multiplied (*) , divided (/.), 
or remaindered (^). The two entries are 
poppped off of the stack, the result is pushed 
on the stack in their place. 



sx 



Ix 



The top of the stack is popped and stored into 
a register named x, where x may be any charac- 
ter. 



The value in register x is pushed on the 
stack. The register x is not altered. 



The top value on the stack is pushed on the 
stack. Thus the top value is duplicated. 



The top value on the stack is printed in de- 
cimal. The top value remains unchanged. 



All values on the stadc are popped off and 
printed in decimal. 



All values on the stack are popped. 



exit. 



print brief synopsis of commands to dc, 

new-line 
space 

ignor ed , 

An example to calculate the monthly, weekly and 
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hourly rates for a $10,000/year salary. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



10000 

100* 

dsa 

12/ 

la52/ 

d10* 

f 

(3) 
(2) 
(1) 



512 

19230 

83333 



^ now xTi C@ni.Sy 

(non-destructive store) 
(pennies per month) 
(pennies per week) 
(deci-pennies per week) 

(print all results) 



? (x) for unrecognized character x. 
% doesn't work correctly, 

ken 
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NAME df — disk free 

SYNOPSIS df [ filesystem ] 

DESCRIPTION df prints out the number of free blocks available 

on a file systenri. If the file system is unspeci— 

printed, 

FILES /dev/rfO, /dev/rkO 

SEE ALSO check 

DIAGNOSTICS 

BUGS 

OWNER ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



dsw — delete interactively 

dsw [ directory ] 

For each file in the given directorjf J,"*" if not 
specified) dsw types its name. If y is typed, 



the file is deleted; if 



dsw exits; if any- 



thing else, the file is not removed. 



rm 



The name dsw is a carryover from the ancient 
past. Its etymology is amusing but the name is 
nonetheless ill-advised. 



OWNER 



dmr , ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



dtf — DECtape format 

/etc/dtf 

dtf will write timing tracks, mark tracks and 
block nvsnbers on a virgin DECtaps, Tli€ format is 
DEC standard of -'78 blocks Oi. 256 wor<jS eacn. 
The end zones are a little longer than standard 
DEC, 

Before use, the tape to be formatted should be 
mounted on drive 0. The 'wall' and 'wtm' 
switches should be enabled. After the tape is 
formatted, the switches should be disabled to 
prevent damage to subsequent tapes due to a con- 
troller logic error. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



sdate 

"?" is typed for any error detected. 



•y\-.-i ST r-.y-r-.rrr- srr, r^r~. a s t-, V-.'.rc i Ca 1 T / Q O^^ d'*!^^© 0- ThS 

processor priority is set very high due to very 
stringent real time requirements. This means 
that all time sharing activities are suspended 
during the formatting (about 1,5 minutes) The 
real time clock will also be slow. 



OWNER 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



du — sumnarize disk usage 
du [r:^][zj]C name ... ] 



d u gives the number of blocks contained in all 
files and (recursively) directories within each 
specified directory or file name . If name is 
missing, j^ is used. 

The optional argxment ^ causes only the grand 
total to be given. The optional argument ^ 
causes an entry to be generated for each file. 
Absence of either causes an entry to be generated 
for each directory only, 

A file which has two links to it is only counted 
once, 

/ 



Files at the top level (not under -a option) are 

not listed. 

Removable file systems do not work correctly 
since i-niombers may be repeated while the 
corresponding files are distinct, Du should 
maintain an i-nxjmber list per root directory 
encountered. 



OWNER 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



ed — editor 

ed [ name ] 

ed is the standard text editor, ed is based on 
QED [reference] but is fully if succinctly- 
described here. Differences between ed and QED 
are also noted to simplify the transition to the 



.k V> k^ ti^ ^^^^ rv ^lv ^ *, «M^b >v «M ^ %>>^ ^ I 



If the optional argument is given, ed simulates 
an e command on the named file; that is to say, 
the file is read into ed's buffer so that it can 
be edited, 

ed operates on a copy of any file it is editing; 
changes made in the copy have no effect on the 
file until an explicit write (w) command is 
given. The copy of the text being edited resides 
in a temporary file called the buffer. There is 
only one buffer. 

Commands to ed have a simple and regular 
structure: zero or more addresses followed by a 
single character command , possibly followed by 
parameters to the command. These addresses 
specify one or more lines in the buffer. Every 
command which requires addresses has default 
addresses, so that the addresses can often be 
omitted. 

In general only one command may appear on a line. 
Certain commands allow the input of text. This 
text is placed in the appropriate place in the 
buffer. While ed is accepting text, it is said 
to be in input mode. In this mode, no commands 
are recognized; all input is merely collected. 
Input mode is left by typing a period (,) alone 
at the beginning of a line, 

ed supports a limited form of recrular expression 
notation, A regular expression is an expression 
which specifies a set of strings of characters, 
A member of this set of strings is said to be 
matched by the regular expression. The regular 
expressions allowed by ed are constructed as 
follows: 

1 , An ordinary character (not one of those 
discussed below) is a regular expression 
and matches that character, 

2, A circumflex (") at the beginning of a reg- 
ular expression matches the null character 
at the beginning of a line. 
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3-. A currency symbol ($) at the end of a regu- 
lar expression matches the null character 
at the end of a line, 

4, A period (.) matches any character but a 
new-line character. 

5, A regular expression followed by an aster- 

***** \ / *"'-n-v-.i«v»» Hii jr siUAui^^i. \j^ ^^J ci^-^ciiu 

occurrences (including zero) of the regular 
expression it follows, 

6, A string of 'characters enclosed in square 
brackets ( [] ) m'atches any character in the 
string but no others. If, however, the 
first character of the string is a circum- 
flex C^) the regular expression matches any 
character but new-line and the characters 
in the string, 

7, The concatenation of regular expressions is 
a regular expression which matches the con- 
catenation of the strings matched by the 
coraponents of the regular expression, 

8, The null regular expression standing alone 
is equivalent to the last regular expres- 
sion encountered. 

Regular expressions are used in addresses to 
specify lines and in one command {s^ see below) 
to specify a portion of a line which is to be 
replaced. 

If it is desired to use one of the regular ex- 
pression metacharacters as an ordinary character, 
that character may be preceded by "\". This also 
applies to the character bounding the regular 
expression (often "/") and to "X itself. 

Addresses are constructed as follows. To under- 
stand addressing in ed it is necessary to know 
that at any time there is a current line , - Gen- 
erally speaking, the current line is the last 
line affected by a command; however, the exact 
effect on the current line by each command is 
discussed under the description of the command, 

1, The character "," addresses the current 
line, 

2, The character "$" addresses the last line 
of the buffer, 

3, A decimal number n addresses the nth line 
of the buffer. 
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4. A regular expression enclosed in slashes 
"/" addresses the first line found by 
searching toward the end of the buffer and 

string matching the regular expression* If 
necessary the search wraps around to the 
beginning of the buffer, 

5i A recrular expression enclosed in f^ueries 
"?" addresses the first line found by 
searching toward the beginning of the 
buffer and stopping at the first line found 
containing a string matching the regular 
expression. If necessary the search wraps 
around to the end of the buffer. 

6, An address followed by a plus sign "+" or a 
minus sign "-" followed by a decimal number 
specifies that address plus (resp, minus) 
the indicated number of lines. The plus 
sign may be omitted. 

Commands may require zero, one, or two addresses. 
Commands which require no addresses regard the 
presence of an address as an error. Commands 
which require the presence of one address all 
assume a default address (often ".") but if given 
more than one address ignore any extras and use 
the last given. Commands which require two ad- 
dresses have defaults in the case of zero or one 
address but use the last two if more than two are 
given. 

Addresses are separated from each other typically 
by a ccxnma (.), They may also be separated by^a^ 
semicolon (;), In this case the current line "," 
is set to the the previous address before the 
next address is interpreted. This feature is 
used to control the^^starting line for forward and 
backward searches ("/"» "?"). 

In the following list of ed commands, the default 
addresses are shown in parentheses. The 
parentheses are not part of the address, but are 
used to show that the given addresses are the 
default. 

As mentioned, it is generally illegal for more 
than one command to appear on a line. However, 
any command may be suffixed by "p" (for "print ). 
In that case, the current line is printed after 
the command is complete. 

In any two-address coimnand, it is illegal for the 
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first address to lie ^ter the second address. 

(.)a 
<text> 

• 

The append command reads the given text and 
■ appends it after the addressed line. "." 
is left on the last line input, if there 
were any^, otherwise at the addressed line. 
Address "o" is legal for this command; text 
is placed at the beginning of the buffer. 
(NOTE: the default address differs from 
that of QED.) 

(.,.)c 
<text> 

• 

The change command deletes the addressed 
lines, then accepts input text which re- 
places these lines. ", is left at the 
last line input; if there were none, it is 
left at the first line not changed. 

( .^ri 
■, » s • / — 

The delete ccxnmand deletes^the addressed 
lines from the buffer. "," is left at the 
first line not deleted. 

e filename 

The edit command causes the entire contents 
of the buffer to be deleted^^ and then the 
named file to be read in, ."is set to 
the last line of the btjffer. The number of 
characters read is typed. 

( 1 »$)g/regular expression/command 

In the global command, the first step is to 
mark every line which matches the given 
regular expression. Then for every such 
line, the given command is executed with 
"." set to that line. The repeated command 
cannot be a, £, i, or c. 

(.)i 
<text> 

• 

This command j.nserts the given text before 
the addressed line. ".." is left at the 
last line input; if there were none, at the 
addressed line. This command differs from 
the a ccxnmand only in the placement of the 
text. 

(...)1 

The Mst command prints the addressed lines 

in an unambiguous way. Non-printing 
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characters are over-struck as follows: 
char prints 



bs 


\ 


tab 


9 


ret 


< 


SI 


i 


SO 


6 



All characters preceded by a prefix (ESC) 
character are printed over— struck with 
without the prefix. Long lines are folded 
with the sequence \newline, 

(.». )P 

The firint ccanmand prints the addressed 
lines, "." is left at the last line print- 
ed. 



The £uit command causes ed to exit. No 
automatic write of a file is done, 

($)r filename 

The read command reads in the given file 
after the addressed line. If no file name 
is given, the file last mentioned in e, r, 
or w commands is read. Address "o" is 
legal for r and causes the file to be read 
at the beginning of the buffer. If the 
read is successful, the^ntunber of charac- 
ters read is typed, "." is left at the 
last line of the file, 

( , , , ) s/regular expression/replacement/ 

The substitute command searches each ad- 
dressed line for an occurence of the speci- 
fied regular expression. On each line in 
which a match is found, the first (and only 
first, compare QED) matched string is re- 
placed by the replacement specified. It is 
an error for the substitution to fail on 
all addressed lines. Any character other 
than space or new-line may be used instead 
of "/ to delimit the regular expression 
and the replacement, ", is left at the 
last line substituted. 

The ampersand "&" appearing in the replace- 
ment is replaced by the regular expression 
that was matched. The special meaning of 

& in this context may be suppressed by 
preceding it by "\", 

( 1 ,$ )w filename 

The write canmand writes the addressed 
lines onto the given file. If no file name 
is given, the file last named in e, r, or w 
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ccxnraands is written, "." is unchanged. If 
the ccxnmand is successful, the number of 
characters written is typed, 

($) = 

The line number of the addressed line is 
typed, "," is unchanged by this command. 

lUNIX command ^ __ 

The remainder of the line after the "l" is 

sent to^UNIX to be interpreted as a com- 
mand, "," is unchanged, 

<newline> „ „ 

A blank line alone is equivalent to ,+1p ; 
it is useful for stepping through text, 

Ed can edit at most 1500 lines and the maximum 
size of a line is 256 characters. The differ- 
ences between ed and QED are: 

1, There is no "\f" character; input mode is 
left by typing "." alone on a line. 

2, There is only one buffer and hence no \b 
stream directive. 

3, The commands are limited to: 

acdegilpqrsw=I 
where e is new, 

4, The only special characters in regular 
expressions are: 

* " $ [ . 

which have^^the usual meanings. However, 
""" and "$" are only effective if they are 
the first or last character respectively of 
the regular expression. Otherwise suppres- 
sion of special meaning^is done by preced- 
ing the character by "V » which is not oth- 
erwise special, 

5, In the substitute command, only the left- 
most occurrence of the matched regular 
expression is substituted, 

7, The a command has a different default ad- 
dress, 

FILES /tmp/etma, etmb, .,, temporary ^ ,, 

/etc/msh is used to implement the I command. 
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SEE ALSO 

DIAGNOSTICS 

BUGS 



? for any error 

ed is used as the shell for the editing system. 
It has the editing system UID built in and if 
invoked under this UID will give slightly dif- 
ferent responses. This is a little kludgy. 



OWNER 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



find — find file with given name 

find name or number ... 

find searches the entire file system hierarchy 
and gives the path names of all files with the 
specified names or (decimal) i-n umbers. 



drar 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 



BUGS 



for — fortran 



for file 



for is a nearly complete fortran compiler, file 
is the name of a fortran source program to be 
compiled. The following is a list of differences 
between for and ANSI standard fortran: 

1 , arbitrary combination of types are allowed in 
expressions. Not all combinations are expected 
to be supported in runtime. All of the normal 
conversions involving integer, real and double 
precision are allowed. 



f ,tmp1 , 2 3 
/etc/f1, 2 3 4 
/etc/xx 



temporary 

passes 

runtime 



Diagnostics are given by number. If the source 
code is available, it is printed with an under- 
line at the current character pointer, A listing 
of error numbers is available. 

The following is a list of those features not yet 
implemented: 



functions 

arithmetic statement 
data statements 
complex constants 
hollerith constants 
continuation cards 



functions 



OWNER 



dmr , ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 
DIAGNOSTICS 



form — form letter generator 
form pro to arg. , . . 



form generates a form letter from a prototype 

xeuucj. y an a»ouv-xa ux V c iii ciii>_/ x jr j a.jL vj «iiicin- t» vuiv^ j.ii >-i 

special case, the current date. 

If form is invoked with the arg\ament x, the fol- 
lowing files coraie into play: 

x.f prototype input 

x.r form letter output 

x.ara associative memory 

form. am associative memory if x.ara not found. 

Basically, form is a copy process from the file 
x.f to the file x.r. If an element of the -form 
\n (where n is a digit from 1 to 9) is encoun- 
tered. The nth argument is inserted in its place, 
and that argument is then re scanned. If \0 is 
encountered, the current date is inserted. If 
the desired argument has not been given, a mes- 
sage of the form \nt is typed. The response 
typed in then is used for that argument. 

If an element of the form [name] is encountered, 
the name is looked up in the associative memory. 
If it is found, the contents of the memory under 
this name replaces the original element (again 
rescanned, ) If the name is not found, a message 
of the form "name: " is typed. The response 
typed in is used for that element. If the asso- 
ciative memory is writable, the response is en- 
tered in the memory under the name. Thus the 
next search for that name will succeed without 
interaction. 

In both of the above cases, the response is typed 
in by entering arbitrary text terminated by two 
new lines. Only the first of the two new lines 
is passed with the text. The process is instant- 
ly terminated if an end of file is encountered 
anywhere except in the associative memory. 



x.f 
x.r 

x. am 

form. am 

type 



input file 
output file 
associative memory 
associative memory 



settup error when the appropriate files cannot 
be located or created. 



BUGS 



settup is misspelled. 
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OWNER rhm, ken 
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HUP (I) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



hup — hang up typewriter 

hup hangs up the phone on the typewriter which 
uses it. 



should not be used; sometimes causes the type- 
writer channel to be lost. 



OWNER 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
gT7(r:g 

CWNER 



Ibppt — load binciry paper tapes 

Ibppt output [ input ] 

Ibppt loads a paper tape in standard UNIX binary 
paper tape format. It is used to bring files to 
a UNIX installation. Currently there is a GECOS 
program to prepare a GECOS file in binary paper 
taoe format. 

If the input file is specified, the character 
stream from that input is expected to be in UNIX 
binary paper tape format. If it is not present, 
/dev/ppt is assumed. The input stream is inter- 
preted, checksuramed, and copied to the output 
file. 

/dev/ppt 

dbppt, bppt format 

checksum"; "usage: "; "read error". 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



Id — link editor 



Id [ -usaol ] 



naune. ] 



Id combines several object programs into one; 
resolves external references; and searches li- 
braries. In the simplest case the names of 
several object programs are givoi, and Id com- 
bines them, producing an object module which can 
be either executed or become the input for a 
further Id run. 

The argument routines are concatenated in the 
order specified. The entry point of the output 
is the beginning of the first routine. 

If any argument is a library, it is searched, and 
only those routines defining an unresolved exter- 
nal reference are loaded. If any routine loaded 
from a library refers to an undefined symbol 
which does not become defined by the end of the 
library, the library is searched again. Thus the 
order of libraries primarily affects the effi- 
ciency of loading, not what routines get loaded. 

Id understands several^flag arguments which are 
written preceded by a "-": 

-s "squash the output, that is, remove the 
symbol table and relocation bits tp save 
space (but impair the usefulness of the 
debugger). This information can also be 
removed by strip , 

-u take the following argument as a symbol and 
enter it as undefined in the symbol table. 
This is useful for loading wholly from a 
library, since initially the symbol table 
is empty and an unresolved reference is 
needed to force the loading of the first 
routine, 

-o set the origin of the load to the octal 

nximber which is given as the next argument. 
This option affects only the definition of 
relocatable external symbols. See DMR 
before using, 

-1 This option is an abbreviation for a li- 
brary name, „"-l'' alone stands for 
"/etc/liba,a'', which is the standard system 
library for assembly language ^programs, 
"-Ix" stands for "/etc/libx.a" where x is 
any character^ There are^libraries for 
Fortran (x="f") and B (x="b"). 
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-a means "absolute" (load at origin absolute 
0) but it doesn't work. 



FILES 

SEE ALSO 
DIAGNOSTICS 



BUGS 



OWNER 



The output of Id is left on a. out . This file is 
executable only if no errors occurred during the 
load, 

/etc/libx,a, for various x; 
/etc/ltina, itmb, ,.. (temporary) 
a, out (output file) 

as, strip, ar (maintains libraries) 

"can't create tert^) file" — unwritable directory 
or someone else is using Id in the same directo- 
ry. 

"can't open temp file" — maybe someone has delet- 
ed it out from under you. 

"file not found" — bad argument 

"bad format"— bad argument 

"relocation error" — bad argument (relocation 
bits corrupted) 

"bad relocation" — user error: a. relocatable 
reference to an external symbol that turns out to 
be absolute, 

"multiply defined" — same symbol defined twice in 
same load 

"un" — stands for "undefined symbol" 

"symbol not found" — loader bug 

Option "-a" doesn't work at all; option "-o 
doesn't work right, 

dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



In — make a link 

In name. [ name- ] 

In creates a link to an existing file name. . If 
name_ is given, the link has that name; otherwise 
it iS placed in the current directory and its 
name is the last ccxnponent of name , 

It is forbidden to link to a directory or to link 
across file systems. 



rm, to unlink 

"?" 

There is nothing particularly wrong with In, but 
links don't work right with respect to the backup 
system: one copy is backed up for each link, and 
(more serious) in case of a file system reload 
both copies are restored and the information that 
a j.inK was invoiveG is xost* 



OWNER 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



Is — list contents of directory 

Is [ -Itasd ] name, .,, 

Is li«ts the contents of one or more directories 
under control of several options: 

1 list in long format, giving i-nunber, mode, 
owner, size in bytes, and time of last 
modification for each file. (see stat for 
format of the mode) 

t sort by time modified (latest first) instead 
of by name, as is normal 

a list all entries; usually those beginning 
with "," are suppressed 

s give size in blocks for each entry 

d if argument is a directory, list only its 
name, not its contents (mostly used with 
"-l" to get status on directory) 

If no argument is given, "." is listed. If an 
argument is not a directory, its name is given. 

/etc/uids to get user ID's for Is -1 

Stat 

"name nonexistent"; "name unreadable"; "name 
unstatable. " 

IJ^ i^ =i» wlien a user cannot be found in 
/etc/uids, the user number printed instead of a 
name is incorrect. It is correct in stat. 



OWNER 



dmr , ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



mail — send mail to another user 



FILES 

SEE ALSO 
DIAGNOSTICS 

BUGS 
OWNER 



mail [ letter person 



] 



mail without an argument searches for a file 
called mailbox , prints it if present, and asks if 
it should be saved. If the answer is "y" , the 
mail is renamed mail , otherwise it is deleted. 
The answer to the above question may be supplied 
in the letter argument. 

When followed by the names of a letter and one or 
more people, the letter is appended to each 
person's mailbox . Each letter is preceded by the 
sender's name and a postmark, 

A person is either the name of am entry in the 
directory /usr . in which case the mail is sent to 
/ usr /per son / mailbox , or the path name of a direc- 
tory, in which case mailbox in that directory is 
used. 

When a user logs in he is informed of the pres- 
ence of mail, 

/etc/uids to map the sender's numerical user ID 
to name; mail and mailbox in various directories, 

init 

"who are you?" if the user cannot be identif ed 
for some reason (a bug), "cannot send to user" 
if mailbox cannot be opened. 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



mesg — permit or deny messages 

roescf [ n ] [ if ] 

mesa n forbids •messages via write by revoking 
non-user write permission on the user's typewrit- 
er, mesq y. reinstates permission, mesg with no 
argument reverses the current permission. In all 
cases the orevious state is retorted- 



FILES 


/dev/ttyn 


SEE ALSO 


write 


DIAGNOSTICS 


-?" if th 




er 


BUGS 


— 


OWNER 


dmr, ken 



if the standard input file is not a typewrit- 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



are made aij- 



mkdir — make a directory 

mkdir dirname 

mkdir creates directory dirname . 

The standard entries "." and "., 
tomatically, 

rmdir to remove directories 
"9- 



No permissions are checked. The system's, user 
ID, not that of the creator of the directory, 
becomes the owner of the directory. 



OWNER 



ken, dmr 
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NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



mkfs — make file system 

/ etc/mkf s t 
/ etc / inkf s i^ 

mkfs initializes either a DECtage^C argument "t") 
or an RK03 disk pack (argxaraent r") so that it 
contains an empty file system, mkfs or its 

be mounted as a file system. 

In both cases the super-block, i-list, and free 
list are initializedj^ and a root directory con- 
taining entries for ." and ".." are created. 
For RKOS's the number of available blocks is 
4872, for tapes 578. 

This program is kept in /etc to avoid inadvertant 
use and consequent destruction of information. 

/dev/tapO, /dev/rkO 



Arg count , Unknown argument , Open error . 



ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



mount — mount file system 

mount special dir 

mount announces to the system that a removable 
file system has been mounted on the device 
corresponding to special file special . Directory 
dir (which must exist already) becomes the name 
of the root of the newlv mounted file svstem. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



umount 

"?", if the special file is already in use, can- 
not be read, or if dir does not exist. 

Should be usable only by the super- user, 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



mv 



— move or rename a file 



FILES 

SEE ALSO 

DIAGNOSTICS 



mv name. name. ... ... 

my chsmges the name of name, by linking to it 
under the name name„ and then unlinking name. . 
Several pairs of arguments may te given. If the 
new name is a directory, the file is moved to 
that directory under its old name. Directories 
may only be moved within the same parent directo- 
ry (just renamed). 



?a — 

?d — 

?s — 

•*?!"__ 

"?u-— 

T-F r 



incorrect argument count 

attempt to move a directory 

moving file to itself 

link error; old file doesn't exist or 

can't write new directory 

can't unlink old name 



then in unable to link back to the old file, the 
result is ?1 and the removal of the target file. 
This is common with demountable file systems and 
should be circumvented. Also in such cases, mv 
should copy if it can. 



OWNER 



ken , dmr 



11/3/71 



NM (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



nm — get name list 

nm [ name ] 

nm prints the symbol table from the output file 
of an assembler or loader run. Only relocatable, 
global, and undefined symbols — not absolute — 
are given. Each defined symbol is preceded by 
its valuei each undefined symbol bv blanks* Glo- 
bal symbols have their first character under- 
lined. The output is sorted alphabetically. 

If no file is given, the symbols in a. out are 
listed. 



FILES 


a. out 


SEE ALSO 


as, Id 


DIAGNOSTICS 


"?" 


BUGS 


— 


OWNER 


dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



od — octal dump 

od name [ origin ] 

od dumps a file in octal, eight words per line 
with the origin of the line on the left, if an 
octal origin is given it is truncated to mod 16 
and dym'^in'^ starts from there- otherwise from. 0, 
Printing continues until halted by sending an 
interrupt signal. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



db 



"9" 



Dumping does not cease at the end of the file; 
instead the file appears to be padded with gar- 
bage to a length of 511 mod 512 bytes. 



OWNER 



ken , dmr 



11/3/71 



PR (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



pr — print file 

pr [ -1cm ] name. ,,, 

pr produces a printed listing of one or more 
files. The output is separated into pages headed 
by the name of the file, a date- and the i^age 
number. 

The optional flag j^l causes each page to contain 
78 lines instead of the standard 66 to accommo- 
date legal size paper. 

The optional flags ^ (current date) and ^^Si 
(modified date) specify which date will head all 
subsequent files, ;jn is default, 

/dev/ttyn to suspend messages, 

cat , cp , me sg 

— (files not found are ignored) 

none 
ken. dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



rew — rewind tape 

rew [ digit ] 

rew rewinds DECtape drives. The digit is the 
logical tape number, and should range from to 

/dev/tapO , ...» /dev/tap7 



? if there is no tape mounted on the indicated 
drive or if the file cannot be opened. 



ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



rkd — dump RK disk to tape 

/etc/rkd 

rkd copies an RK03/RK05 disk pack onto nine 
DECtapes, 

Physical I/O is done and interrupts are disabled, 
so time— sharing is suspended during operation of 
the command. 

The sequence of tape drives is: 0, 1, 0, 1, ,.,, 

rkd exits if appears in the console switches. 



rkl 



none; errors are retried forever 



OWNER 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



rkf — format RK03 disk pack 

rkf 

rkf formats a virgin disk pack. Because it des- 
troys all information on that pack, and because 
it is not interlocked against file system activi- 
ty on the pack, the rkf program is not maintained 






located and assembled, 

none (uses physical I/O on drive 0), 



error is printed and a core image is produced 
if a write error occurs, A copy of the RK status 
register is in register 5, 

As mentioned, rkf is not interlocked against sys- 
tem I/O; if I/O is already occurring, it will be 
badly disrupted. In any event, all information 
on the pack is destroyed. 



OWNER 



ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



rkl — reload RK diskj from tape 
/etc/rkl 

rkl loads an RK05/RK05 disk pack from nine 
DECtapes, 

The program uses physical I/O with interrupts 

,^* r•s.^^^ aAt •i-V.Qi-o-frM-a -H mo — eViar-i r>rr is sii sr> Pn rt Art _ 

Only the super-user may invoke this command. 

The sequence of drives is: 0, 1, 0, 1, .,,, rkl 
will cease if appears in the console switches. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



rkd 



none; errors are retried forever 



Ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



rm — remove (unlink) files 

rm name ,, . 

rm removes the entries for one or more files from 
a directory. If an entry was the last link to 
the file, the file is destroyed. Removal of a 
file requires write permission in its directory, 
but neither read, nor write permission on the file 
itself. 

Directories cannot be removed by rm; cf . rmdir, 

none 

rmdir, for removing directories. 

If the file cannot be removed or does not exist, 
the name of the file followed by a question mark 
is typed, 

rm probably should ask whether a read-only file 
is really to be removed. 



OWNER 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 

OWNER 



rmdir — remove directory 
"l 



rrodi r dir^ . , 



rmdir removes (deletes) directories. The direc- 
tory must be emptj/^ (except for the standard en- 
tries "," and ".. , which rmdir itself removes). 
Write permission is required in the directory in 



rVi-i ^Vi •hVi^ rM r»nfTtr\r ann^ars 



none 



"dir?" is printed if directory dir cannot be 
found, is not a directory, or is not removable, 

"dir — directory not empty" is printed if dir 
has entries other than ", or ,, , 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



roff — format text 

roff [ +number ] [ -nxanber ] name. ,,, 

roff formats text according to control lines 
embedded^^in the text. The optional argument 
''+number'* causes printing to begin^^at the first 
page with the appropriate nxomber; "-number" 
causes '^rintin" to cease at the first ■'^a'^e with a 
higher number. 

roff is fully described in a separate publication 
[reference] . 

/etc/suftab contains a list of suffixes used to 
guide hyphenation, /tmp/rtma, rtmb, ,,, tem- 
porary, /dev/ttyn to suspend messages. 

[reference] , mesg 

none — files not fovuid are ignored 

roff does not check for various kinds of buffer 
overflow. If a fault occurs, check the input in 
the region where the error occurred. 

jfo, dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



sdate — set date and time 

sdate mmddhhmm 

sdate adjusts the system's idea of the date and 
time, ^ is the month number; dd is the day 
number in the month; hh is the hour number 
(24-hour system); nun is the minute number. For 
example, 

sdate 10080045 

sets the date to Oct. 8, 12:45 AM, 

none 

date 

"?" if the date is syntactically incorrect, 

none 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



sh — shell (command interpreter) 



sh [ name [ arg. 



[ argg ] ] ] 



sh is the standard command interpreter. It is 
the program which reads and arranges the execu- 
tion of the command lines typed by most users. 
It may itself be called as a command to interpret 
files of ccMnmand lines* Before discussing the 
arguments to the shell used as a canmand, the 
structure of command lines themselves will be 
given. 

Command lines are sequences of commands separated 
by command delimiters. Each command is a se- 
quence of non-blank command arguments separated 
by blanks. The first argument specifies the name 
of a command to be executed. Except for certain 
types of special arguments discussed below, the 
arguments other than the command name are simply 
passed to the invoked command. 

If the first argxament represents the path name of 
an executable^file, it is invoked; otherwise the 
string "/bin/" is prepended to the argument. (In 
this way the standard commands, which reside in 
"/bin", are found.) If this search too fails a 
diagnostic is printed. 

The remaining non-special arguments are simply 
passed to the command without fvurther interpreta- 
tion by the shell. 

There are three^comraand delimiters:^ the new 
line, ";", and "&", The semicolon ";" specifies 
sequential execution of the commands so 
separated; that is, 

coma ; comb 

causes the execution first^of command coma , then 
of comb . The ampersand "&" causes simultaneous 
execution: 

coma & comb 

causes coma to be called, followed immediately by 
comb without waiting for coma to finish. Thus 
coma and comb execute simultaneously. As a spe- 
cial case, 

coma & 

causes coma to be executed and the shell immedi- 
ately to request another command without waiting 
for coma. 
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Two Characters cause the iiiinediately following 
string to be interpreted as a special argument to 
the shell itself, not^passed to the canmand. An 
argument of the form "<arg" causes the file arg 
to be used as the standard input file of the^^ 
given command; an argument of the form "Varg" 
causes file "arg" to be used as the standard out- 

niTh -Ft 1 1= -FriT- l-Vi*! cfiMf^n r'ommsnri- 
t">»— ^ — — — ^ — ^ — ..— z> ~ • — ' 

If any argument contains either of the characters 
"?" or "* , it is treated specially as foll'ows. 
The current directory is searched for files^which 
match the given argument. The character "*" in 
an argument matches any string of characters in a 
file name (including the null string); '?" 
matches any single character in a file name. 
Other argument characters match only the same 
character in the file namej^ For example, "*" 
matches all file names; "? " matches all one-char- 
acter file names; '|ab*.s" matches all f^le names 
beginning with "ab" and ending with ".s , 

If^the argument with "*" or "? " also contains a 
"/", a slightly different procedure is used: 
instead of the current directory, the directory 
used is the one obtained by taking the argument 
up to the last "/" before a "♦" or "?". The 
matching process matches the remainder of the 
argument after this "/" against the files in the 
derived directory. For example: "/usr/dmr/a*. s 
matches all^^files in directory "/usr/dmr which 
begin with "a" and end with ".s , 



In any event, a list of names is obtained which 
match the argument. This list is sorted into 
alphabetical order, and the resulting sequence of 
arguments replaces the single argument containing 
the "♦"or "?". The same^^process is carried out 
for each argument with a "*" or "?" (the result- 
ing lists are not merged) and finally the command 
is called with the resulting list of arguments.. 

For example: directory /usr/dmr contains the 
files al.s, a2.s, ..., a9.s. From any directory, 
the command 

as /usr/dmr/a? .s 

calls as with arguments /usr/dmr/a1 .s , 
/usr/dmr/a2.s, ... /usr/dmr/a9.s in that order. 

The character "\" causes the immediately follow- 
ing character to lose any special meaning it may 
have to the shell; in this way "<", > , and 
other characters meaningful to the shell may be 
passed as part of arguments. A special case of 
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this feature allows the continuation of commands 
onto more than one line: a new-line preceded by 
"\" is translated into a blank. 

Sequences of characters enclosed in double ( ) or 
single (') quotes are also taken literally. 

When the shell is invoked as a command, it has 



T>^ 



call that the form in which the whell is invoked 
is 

sh [ name [ arg^ ... [ arg^ ] ] ] 

The name is the name of a file which will be read 
and interpreted. If not given, this subin stance 
of the shell will continue to read the standard 
input file. 

In the file, character sequences of the form 
"$n'*, where n is a digit 0, ..., 9, are replaced 
by the nth argument to the invocation of the 
shell (arg^). "$0" is replaced by name . 

An end-of-file in the shell's input causes it to 
exit. A side effect of this fact means that the 
way to log out from UNIX is to type an end of 
file. 

FILES /etc/glob 

SEE ALSO [reference] , which gives the theory of operation 

of the shell. 

DIAGNOSTICS "?"f ^^ case of any difficulty. The most common 

problem is inability to^find the given command. 
Others: input file ("<") cannot be found; no 
more processes can be created (this will allevi- 
ate itself with the passage of time). Note that 
ro diagnostic is given for inability to create an 
output (">") file; the standard output file has 
already been closed when the condition is 
discovered and there is no place to write the 
diagnostic. 

If a "*" or "?" is^^used, the glob routine is 
invoked; it types "no command if it cannot find 
the given command, and "no match" if there^were 
no files which matched an argument with "?" or 

• 

BUGS Better diagnostics should be provided. If a "*" 

or "?" is used, the command must be in /bin . 
(Not, for example, in the user's directory.) This 
is actually a glob bug. 
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OWNER dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 

DIAGNOSTICS 
BUGS 



Stat — get file status 

Stat name. . , , 

Stat gives several kinds of information about one 
or more files: 

i -number 

access "*'^de 

number of links 

owner 

size in bytes 

date and time of last modification 

name (useful when several files are named) 

All information is self-explanatory except the 
mode. The mode is a six-character string whose 
characters mean the following: 

1 s: file is small (smaller than 4096 bytes) 
1: file is large 

2 d; file is a directory 
Xi jLxxe J. a exev^unciDi. e 

u: set user ID on execution 
-: none of the above 

3 r: owner can read 

-: owner cannot read 

4 w: owner can write 

-: owner cannot write 

5 r: non-owner can read 

-: non-cwner cannot read 

6 w: non-owner can write 

-: non-owner cannot write 

The owner is almost always given in symbolic 
form; however if he cannot be found in 
"/etc/uids" a number is given. 

If the niiraber of arguments to stat is not exactly 
1 a header is generated identifying the fields of 
the status information, 

/etc/uids 

Is with the "-l" option gives the same informa- 
tion as stat . 

"name?" for any error. 

none 
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OWNER dmr 
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STRIP (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



Strip — remove symbols and relocation bits 

strip narae^ , . , 

strip removes the symbol table and relocation 
bits ordinarily attached to "the output of the 
assembler and loader. This is useful to save 
space a^-ter a program has been debugged. 

The effect of strip is the same as use of the ;;^ 
option of Id , 



/tmp/stma, stmb ,,,• 
Id . as 



temporary file 



Diagnostics are given for: non-existent argument; 
inability to create temporary file; 
improper format (not an object file); 
inability to re-read temporary file. 



BUGS 
OWNER 



dmr 
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SU (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



SU 



— become privileged user 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



SU password 

SU allows one to, become the super-user, who has 
all sorts of marvelous powers. In order for su 
to do its magic, the user must pass as an argu- 
ment a password, if the password is correct, su 

--J 1 1 _.4 4. I-— _1_ — 1 T ..J^t. 4.1.A nXr» B.^4- .t.^ 4-^34- 

of the super-user. To restore normal UID 
privileges, type an end-of-file to the super-user 
shell. 



shell 

"sorry" if password is wrong 

dmr, ken 
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SUM (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



sum 



— sum file 



sum name 



sum sums the contents of a file. In practice, it 
is most often used to verify that all of a 
DECtape can be read without error. 







SEE ALSO 





DIAGNOSTICS 


erroj 


BUGS 


none 


OWNER 


ken 



if the file cannot be read at all or if an 
error is discovered during the read. 
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NAME tap — manipulate DECtape 

SYNOPSIS tap [ key ] [ name , . . ] 

DESCRIPTION tap saves and restores selected portions of the 

file system hierarchy on DECtape, Its actions 
are controlled by the key argument. The key is a 
string of characters containing at most one func- 
txon j.etuer an<a pcssxuj.y one or mors i.unci.j.on 
modifiers. Other arguments to the command are 
file or directory names specifying which files 
are to be dumped, restored, or tabled. 

The function portion of the key is specified by 
one of the following letters: 

r The indicated files and directories, to- 
gether with all subdirectories, are dumped 
onto the tape. If files with the same 
names already^exist , they are replaced 
(hence the "r"), "same" is determined by 
string comparison, so ' ./abc' can never be 
the same as "/usr/dmr/abc" even if 
"/usr/dmr is the current directory. If no 
file argument is given, ' /" is the default. 



u updates the tape, u is the same as r, but 
a file is replaced only if its modification 
date is later than the date stored on the 
tape; that is to say, if it has changed 
since it was dumped, u is the default com- 
mand if none is given. 

d deletes the named files and directories 
from the tape. At least one file argument 
must be given, 

X extracts the named files from the tape to 
the file system. The owner, mode, and 
date-modified are restored to what they 
were when the file was dumped. If no file 
argument is given, the entire contents of 
the tape are extracted, 

t lists the names of all files stored on the 
tape which are the same as or are hierarch- 
ically below the file arguments. If no 
file argument is given, the entire contents 
of the tape are tabled, 

1 is the same as t except that an expanded 
listing is produced giving all the avail- 
able information about the listed files. 

The following characters may be used in addition 
to the letter which selects the function desired. 
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0, ...f 7 This modifier selects the drive on 
which the tape is mounted. "o" is the 
default, 

V Normally tap does its work silently. The v 
(verbose) option causes it to type the name 
of each file it treats preceded by a letter 

— ..... . .. . — •*^to*«^* 



~cc • 



r file is being replaced 

a file is being added (not there before) 

X file is being extracted 

d file is being deleted 

The V option can be used with r, u, d, and 
X only, 

c means a fresh dump is being created; the 
tape directory will be zeroed before begin- 
ning. Usable only with r and u, 

f causes new entries copied on tape to be 
'fake' in that only the entries, not the 
data associated with the entries are updat- 
ed. ?5uch fake entries cannot be extracted. 
Usable only with r and u, 

w causes tap to pause before treating each 
file, type the indicative letter and the 
file name (as with v^ await the user's 
resppnse. Response y" means yes , so the 
file* is treated. Null response means "no' , 
and the file does not take gart in whatever 
is being done. Response "x means exit ; 
the tap command terminates iitmediately. In 
the X function, files previously asked 
about have been extracted already. With r, 
u, and d no change has been made to the 
tape, 

m make (create) directories during an x if 
necessary, 

i ignore tape errors. It is suggested that 
this option be used with caution to read 
damaged tapes. 



FILES /dev/tapO . . . /dev/tap7 

SEE ALSO rk 

DIAGNOSTICS RK open error 

RK read error 
RK write error 
Directory checksum 
Directory overflow 
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RK overflow 

Phase error (a file has changed after it was 

selected for dumping but before it was dtunped) 

BUGS All references to "rk" should read "tape," The m 

option does not work correctly in all cases. The 
i. option is not yet implemented. 
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TM (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 



SEE ALSO 



DIAGNOSTICS 



BUGS 



tim 


77*43! 20 


ovh 


13:59:42 


dsk 


12:06:30 


idl 


352:31:37 


usr 


3:32:15 


der 


5, 171 



tm — provide time information 

tm [ command arg^ .... ] 

tm is used to provide timing information. When 
used without an argument, output like the follow- 
ing is given: 



29.2 

r.2 

4.1 

23.7 

0.1 





The first column of numbers gives totals in the 
named categories since the last time the system 
was cold-bDoted; the second colxjmn gives the 
changes since the last time tm was invoked. The 
tim row is total real time (hours: minutes: 
seconds); unlike the other times, its origin is 
the creation date of tm's temporary file, ovh is 
time spent executing in the system; dsk is time 
spent waiting for both kinds of disk l/O; idl is 
idle time; usr is user execution time; der is RF 
disk error count (left number) and RK disk error 
count (right number), 

tm can be invoked with arguments which are as- 
sumed to constitute a command to be timed. In 
this case the output is as follows: 



tim 


2.2 


ovh 


0,3 


dsk 


1,8 


idl 


0.0 


usr 


0.0 



The given times represent the number of seconds 
spent in each category during execution of the 
cOTtimand. 

/tmp/ttmp, /dev/rfO (for absolute times) contains 
the information used to calculate the differen- 
tial times. 

format of file system (which tells where the 
times come from) 

"?" if the ccromand cannot be executed; "can't 
creat temp file" if trouble with ttmp ; "cant read 
super-block" if times cannot be read from system. 

(1) when invoked with a command argument, every- 
thing going on at the moment is counted, not just 
the command itself. (2) Two users doing tm 
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simultameously interfere with each other's use of 
the temporary file, 

rtilKTITD Irian i^mt- 
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TTY (I) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



tty — 
ttZ 



get tty name 



tty gives^^the name of the user's typewriter in 
the form "ttyn" for n a^ digit. The actual path 
name is then '/dev/ttyn , 



"not a tty" if the standard input file is not a 
typewriter. 



dmr, ken 
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TYPE (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



type — type on 2741 

type name , , , 

type produces output on an IBM 2741 terminal with 
a Correspondence type ball, 

type uses typewriter tty5, which, because of the 
lack of access ports ^ is also used as a standard 
ccxnmunication channel. Therefore, who should be 
used to verify the absence of a user on ttyS, 

The method is as follows: type the type command. 
It will wait until ttyS is dialled up. When the 
phone answers, depress the interrupt button after 
paper has been loaded, and the first file will be 
typed. type spaces out to the end of a sheet of 
paper and waits until the interrupt button is 
depressed before beginning each new file. 

/dev/tty5 

who 



Obviously some scheme is needed to prevent in- 
terference between normal users and type . The 
best thing would be to support 2741 's as a stan- 
dard terminal. 



OWNER 



dmr 
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UMOUNT (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



umount — dismount file system 

umount special 

umount announces to the system that the removable 
file system previously mounted on special file 
special is to be removed, 

Onlv the suoer-user mav issue this command. 



FILES 


— 


SEE ALSO 


mount 


DIAGNOSTICS 


? 


BUGS 


This comi 




user. 


OWNER 


ken , dmr 



This command should be restricted to the super- 
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UN (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



un — undefined symbols 

un [ name ] 

un prints a list of undefined symbols from an 
assembly or loader run, if the file argument is 
not specified, a. out is the default. Names are 
listed alphabetically except that non-global sym- 
bols come firsts Undefined crlobal svtnbols (un- 
resolved external references) have their first 
character underlined, 

a, out 

as, Id 

"?" if the file cannot be found. 



dmr , ken 
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WC (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



WC — get (English) word count 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



WC name. ... 

WC provides a count of the words, text lines, and 
roff control lines for each argument file. 



A text line is a sequence of characters not be- 
«« ii 

'^^.^••^..'3 .. ^w.. . _..« _.. _ __, — .. n~h " I 

control line is a line beginning with . , A 
word is a sequence of characters bounded by the 
beginning of a line, by the end of a line, or by 
a blank or a tab. 



roff 

none; arguments not found are ignored. 



jfo 
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WHO (I) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



who — who is on the system 

who 

who lists the name, typewriter channel, and login 
time for each current UNIX user, 

/tmp/utmp contains the necessary information; it 
is maintained by init . 

/etc/init 



dmr, ken 
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WRITE (I) 



NAME 

SYNOPSIS 

DESCRIPTION 



write — write to another user 

write user 

write copies lines from your typewriter to that 
of another user. When fxrst caxled^ write sends 
the message 

message from yourname,,. 

The recipient of the message should write back at 
this point. Communication continues until an end 
of file is read from the typewriter or an inter- 
rupt is sent. At that point write writes "eot" 
on the other terminal. 

Permission to write may be denied or granted by 
use of the mesg command. At the outset writing 
is allowed. Certain commands, in particular roff 
and ££, disallow messages in order to prevent 
messy output. 



If the character 1 is found at the beginning of 
a line, write calls the mini-shell msh to execute 
the rest of the line as a command. 



FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



The following protocol is suggested for using 
write ; When you first write to another user, wait 
for him to write back before starting to send. 
Each party should^end^each message with a dis- 
tinctive signal ("(o)" for "over is convention- 
al) that the other may reply, "(oo)" (for "over 
and out") is suggested when conversation is about 
to be terminated, 

/tmp/utmp is used to discover the target user's 
typewriter channel and the sending user's name. 
msh is used to execute commands, 

mesg 

"user not logged in"; "permission denied". 



drar, ken 
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SYS BREAK (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



break — set program break 

sys break; addr / break =17. 

break sets the system's idea of the highest loca- 
tion used by the program to addr. Locations 
greater than addr and below the stack pointer are 
not swapped and are thus liable to unexpected 
modification 

If the argument is or higher than the stack 
pointer the entire 4K word user core area is 
swapped. 

When a program begins execution via exec the 
break is set, at the highest location defined by 
the program and data storage areas. Ordinarily, 
therefore, only programs with growing data areas 
need to use break. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



exec 

none; strange addresses cause the break to be set 
to include all of core. 



ken, dmr 
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SYS CEMT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



cemt — catch emt traps 



FILES 

SEE ALSO 

DIAGN06TICS 

BUGS 

OWNER 



sys 



cemt; arg / cemt = 2 9,; not in assembler 



This call allows one to catch traps resulting 
from the emt instruction, Arg is a location 
within the program; emt traps are sent to that 
location. The normal effect of emt traps may be 
re3i,ore<a ^y yxVj.ny an ar g eguaj. to u. 

Prior to the use of this call, the result of an 
emt instruction is a simulated rts instruction. 
The operand field is interpreted as a register, 
and an rts instruction is simulated for that 
register (after verifying that various registers 
have appropriate values). This feature is useful 
for debugging, since the most dangerous program 
bugs usually involve an rts with bad data on the 
stack or in a register. 



ken, dmr 
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SYS CHDIR ( Ip) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



chdlr — change working directory 

sys chdir; dirname / chdir = 12. 

dirname is address of the pathname of a directo- 
ry, terminated by a byte. chdir causes this 
directory to become the current working directo- 
ry. 



The error bit (c-bit) is set if the given name is 
not that of a- directory. 



ken, dmr 
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SYS CHMOD (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



chmod — change mode of file 

sys chmod; name; mode / chmod = 15. 

The file whose name is given as the null- 
terminated string pointed to by name has its mode 
changed to mode . Modes are constructed by oring 
together some combination of the following: 

01 write, non-owner 

02 read, non-owner 
04 write, owner 

1 read , owner 

20 executable 

40 set user ID on execution 

Only the owner of a file (or the super-user) may 
change the mode. 



Error bit (c-bit) set if n ame cannot be found or 
if current user is neither the owner of the file 
nor the super-user. 



ken, dmr 
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SYS CHOWN (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



chown — change owner of file 
sys chown; name; owner 



/ chown = 15, 



The file whose name is given by the null- 
terminated string pointed to by name has its own- 
er changed to owner. Only the present owner of a 
file (or the super-user) may donate the file to 

of a file with the set-user-ID bit on, otherwise 
one could create Trojan Horses able to misuse 
other's files. 



FILES 
SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



/etc/uids has the mapping between user names and 
user numbers. 

The error bit (c-bit) is set on illegal owner 
changes. 



icen, dmr 
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SYS CLOSE (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



close — close a file 



(file descriptor in rO ) 
sys close 



/ ciose = D, 



Given a file descriptor such as returned from an 
open or creat call, close closes the associated 
file, A close of all files is automatic on exit. 

1 — .A. ^ ^ -^ ^^ ^^-^^^^^^^^ ^ -^ ^ 1 4 ^^i X, ^^ *m ^ 4r\ »J ..... .1 A. -. » ^ 

ously open files, c lose is necessary to programs 
which deal with many files. 



creat, open 

The error bit (c-bit) is set for an unknown file 
descriptor. 



BUGS 
OWNER 



ken, dmr 
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SYS GREAT (ll) 



NAME 
SYNOPSIS 

DESCRIPTION 



creat — create a new file 

sys creat; name; mode 
(file descriptor in rO) 



/ creat = 8, 



creat creates a new file or prepares to rewrite 
an existing file called name ; name is the address 
of a null— terminated strin^^. If the file did not 
exist, it is given mode mode ; if it did exist, 
its mode and owner remain unchanged but it is 
truncated to length. 

The file is also opened for writing, and its file 
descriptor is returned in rO. 

The mode given is arbitrary; it need not allow 
writing. This feature is used by programs which 
deal with temporary files of fixed names. The 
creation is done with a mode that forbids writ- 
ing. Then if a second instance of the program 
attempts a creat . an error is returned and the 
program knows that the name is unusable for the 
moment . 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 
OWNER 



If the last link to an open file is removed the 
file is not destroyed until the file is closed. 



write, close 

The error bit (c-bit) may be set if: a needed 
directory is not readable; the file does not 
exist and the directory in which it is to be 
created is not writable; the file does exist and 
is unwritable; the file is a directory. 



ken, dmr 
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SYS EXEC (II) 



NAME exec — execute a file 

SYNOPSIS sys exec; name; args 

name: <...\0> 

• • • 
args : arg1 ; arg2 ; • • • ; 
argi : <. . .\0> 



/ exec =11 



DESCRIPTION 



exec overlays the calling process with the named 
file, then transfers to the beginning of the core 
image of the file. The first argument to e xec is 
a pointer to the name of the file to be executed. 
The second is the address of a list of pointers 
to arguments to be passed to the file. Conven- 
tionally, the first argxjment is the name of the 
file. Each pointer addresses a string terminated 
by a null byte. 

There can be no return from the file; the calling 
core image is lost. 

The program break is set from the executed file; 
see the format of a. out. 

Once the called file starts execution, the argu- 
ments are passed as follows. The stack pointer 
points to the number of arguments. Just above 
this number is a list of pointers to the argument 
strings. 



sp-> 



nargs 
arg1 



argn 
arg1 : <arg1\0> 

• • • 

argn: <argn\0> 

The arguments are placed as high as possible in 
core: just below 60000(8). 

Files remain open across exec calls. However, 
the illegal instruction, emt . quit, and interrupt 
trap specifications are reset to the standard 
values, (See i lqins . cemt . quit , intr , ) 

Each user has a real user ID and an effective 
(The real ID identifies the person using the 
system; the effective ID determines his access 
privileges, ) exec changes the effective user ID 
to the owner of the executed file if the file has 
the "set-user-ID" mode. The real user ID is not 
affected. 
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FILES 

SEE ALSO fork 

DIAGNOSTICS If the file cannot be read or if it is not exe- 
cutable, a return from exe c constitutes the diag- 
nostic. The error bit (c-bit) is set. 

BUGS — 

OWNER ken, dmr 
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SYS EXIT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



exit — terminate process 

sys exit / exit = 1 

exit is the normal means of terminating a pro- 
cess. All files are closed and the parent pro- 
cess is notified if it is executing a wait. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



sys wait 



ken, dmr 
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SYS FORK (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



fork 



spawn new process 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWN ER 



sys fork / fork = 2. 
(new process xeturn) 
(old process return) 

fork is the only way new processes are created. 
The new process's core image is a copy of that of 



^S 1 1 A'T- 









return location and the fact that rO in the old 
process contains the process ID of the new pro- 
cess. This process ID is used by wait . 



sys wait, sys exec 

The error bit (c-bit) is set in the old process 
if a new process could not be created because of 
lack of swap space. 

See wait for a subtle bug in process destruction, 

ken, dmr 
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SYS FSTAT (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



fstat — get status of open file 

(file descriptor in rO) 

sys fstat I buf / fstat = 28, 

This call is identical to stat . except that it 
operates on open files instead of files given by 
name. It is most often used to get the status of 



are unknown. 






FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



sys Stat 

The error bit (c-bit) is set if the file descrip- 
tor is unknown. 



ken, dmr 
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SYS GETUID (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
DIAGNOSTICS 
BUGS 
OWNER 



getuid — get user identification 
sys getuid / getuid =24, 

yUOOX JLU XXI ^^ f 

getuid returns the real user ID of the current 
process. The real user ID identifies the person 
who is logged in, in contradistinction to the 
effective user ID which determines his access 
permission at each moment. It is^thus useful ^^ to 
programs which operate using the 'set user ID 
mode, to find out who invoked them. 

/etc/uids can be used to map the user ID number 
into a name, 

setuid 



ken, dmr 
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SYS GTTY (II) 



NAME 
SYNOPSIS 



gtty — get typewriter status 






DESCRIPTION 



(file descriptor in rO) 

• • • 

arg: .=,+6 

gtty stores in the three words addressed by arg 
•hVjQ states of the t'"'^swriter whose file descrii^ — 
tor is given in rO. The format is the same as 
that passed by stty . 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



stty 

Error bit (c-bit) is set if the file descriptor 
does not refer to a typewriter. 



ken, dmr 
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SYS ILGINS (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



ilgins — catch illegal instruction trap 

sys ilgins; arg / ilgins = 33.; not in assembler 

ilgins allows a program to catch illegal instruc- 
tion traps. If arg is zero, the normal instruc- 
tion trap handling is done: the process is ter- 
minated and a core image is produced. If arg is 

a jnj>„cn-a.>ji» vvj.i_iijLti uiic ^x u>j J. dill, >_(jin-j.ui xs passeu 

to arg when the trap occurs. 

This call is used to implement the floating point 
simulator, which catches and interprets 11/45 
floating point instructions. 



fptrap . the floating point package 



ken, dmr 
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SYS INTR (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



intr — set interrupt handling 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



sys 



intr; arg 



/ intr = 27. 



When arg is 0, interrupts (ASCII DELETE) are 
ignored. When arg is 1, interrupts cause their 
normal result, that is, force an e xit . When arg 
is a location within the program, control is 

occurs. 

After an interrupt is caught, it is possible to 
resume execution by means of an rti instruction; 
however, great care must be exercised, since all 
I/O is terminated abruptly upon an interrupt. In 
particular, reads of the typewriter tend to re- 
turn with characters read, thus simulating an 
end of file. 



quit 



It should be easier to resume after an interrupt, 
but I don't know how to make it work. 



OWNER 



ken, dmr 
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SYS LINK ( it) 



NAME 

SYNOPSIS 

DESCRIPTION 



link — link to a file 

sys link; name^ ; namej / link = 9. 

A link to n ame ^ is created; the link has name 
name ^. Either 'name may be an arbitrary path 
namet 



UJ-LiBto 

SEE ALSO 
DIAGNOSTICS 



BUGS 
OWNER 



unlink 

The error bit (c-bit) is set when name ^ cannot be 
found; when name ^ already exists; when the direc- 
tory of name ^ cannot be written; when an attempt 
is made to link to a directory by a user other 
than the super-user. 



ken, dmr 
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SYS MKDIR (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



mkdir — make a directory 

sys mkdir; name; mode / mkdir = 14. 

mkdir creates an empty directory whose name is 
the null-terminated string pointed to by name . 
The mode of the directory is mode . The special 
entries "." and ".." are not present. 

mkdir can only be invoked by the super-user. 



mkdir command 

Error bit (c-bit) is set if the directory already 
exists or if the user is hot the super-user. 



ken, dmr 
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SYS MOUNT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



mount — mount file system 

sys mount; special; name / mount =21.; not in assembler 

mount announces to the system that a removable 
file system has been mounted on special file 
special ; from now on, references to file name 
will refer to the root file on the newly mounted 



■F^ 1 



^ 1 " 
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null-terminated strings containing the appropri- 
ate path names. 

Name must exist already. If it had useful con- 
tents, they are inaccessible while the file sys- 
tem is mounted. 

Almost always, name should be a directory so that 
an entire file system, not just one file, may 
exist on the removable device. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



umount 

Error bit (c-bit) set if spe cia l is inaccessible 
or dir does not exist. 

At most one removable device can be mounted at a 
time. The use of this call should be restricted 
to the super-user. 



OWNER 



ken, dmr 
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SYS OPEN (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



open — open for reading or writing 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 
OWNER 



sys open; name; mode 
(descriptor in rO ) 



/ open = 5. 



open opens the file name for reading (if m ode is 
0) or writing (if mode is non-zero). name is the 
address of a string of ASCII characters 
representing a path natne, termlnatsu by a null 
character. 

The file descriptor should be saved for subse- 
quent calls to read (or write) and close. 

In both the read and write case the file pointer 
is set to the beginning of the file. 

If the last link to an open file is removed, the 
file is not destroyed until it is closed. 



creat, read, write, close 

The error bit (c-bit) is set if the file does not 
exist, if one of the necessary directories does 
not exist or is unreadable, or if the file is hot 
readable. 



ken, dmr 
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SYS QUIT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



quit — turn off quit signal 

sys quit; flag / quit = 26. 

When flag is 0, this call disables quit signals 
from the typewriter (ASCII FS). When flag is 1, 
quits are re-enabled, and cause execution to 
cease and a core image to be produced. When flag 
is an address in tne program, a qux<- causes con~ 
trol to be sent to that address. 

Quits should be turned off only with due con- 
sideration. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

0V7NER 



sys Intr turns off interrupts 



ken, drar 
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SYS READ (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



read 



— read from file 



FILES 

SEE ALSO 

DTAnMOSTTrS 



BUGS 
OWNER 



(file descriptor in rO ) 

sys read; buffer; n chars 

(nread in rO) 



/ read = d. 



A file descriptor is a word returned from a suc- 
cessful ope n call. 

Buffer is the location of n chars contiguous bytes 
into which the input will be placed. It is not 
guaranteed that all nchars bytes will be read, 
however; for example if the file refers to a 
typewriter at most one line will be returned. In 
any event the number of characters read is re- 
turned in rO. 

If rO returns with value 0, then end-of-file has 
been reached. 



open 

As mentioned, rO is on return when the end of 
the file has been reached. If the read was 
otherwise unsuccessful the error bit (c-bit) is 
set. Many conditions, all rare, can generate an 
error: physical l/O errors, bad buffer address, 
preposterous n chars . file descriptor not that of 
an input file. 



ken, dmr 
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SYS RELE (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



rele — release processor 

sys rele / rele = 0; not in assembler 

This call causes the process to be swapped out 
immediately if another process wants to run. Its 
main reason for being is internal to the system, 
namely to implement timer-runout swaps. However, 
it can be used benaf iciallv by procrrams which 
wish to loop for some reason without consuming 
more processor time than necessary. 



ken, dmr 
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SYS SEEK (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



seek — move read/write pointer 
(file desdriptor in rO) 



seek = 19. 



The file descriptor refers to a file open for 
reading or writing. The read (or write) pointer 
for the file is set as follows: 

if ptrname is 0, the pointer is set to o ffse t. 

if ptrname is 1 , the pointer is set to its 
current location plus offset . 

if ptrname is 2, the pointer is set to the 
size of the file plus offset . 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



tell 

The error bit (c-bit) is set for an undefined 



i.xxe kuco ci xi-' i-ui. • 



A file can conceptually be as large as 2**20 
bytes. Clearly only 2**16 bytes can be addressed 
by seek. The problem is most acute on the tape 
files and RK and RF. Something is going to be 
done about this. 



OWNER 



ken, dmr 



11/3/71 



SYS SETUID (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



setuid 



set process ID 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



(process ID in rO) 
sys 






The user ID of the current process is set to the 
argument in rO. Both the effective and the real 
user ID are set. This call is only permitted to 






getuid 

Error bit (c-bit) is set if the current user ID 
is not that of the super-user. 



ken, dmr 
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SYS SMDATE (ll) 



NAME 
SYNOPSIS 

DESCRIPTION 



smdate — set modified date on file 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



(time to AC-MQ) 






File is the address of a null-terminated string 
giving the name of a file. The modified time of 
the file is set to the time given in the AC-MQ 

This call is allowed only to the super-user. 



Error bit is set if the user is not the super- 
user or if the file cannot be found. 



ken, dmr 
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SYS STAT (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



buf 


, +1 


+ 2, 


+ 3 


+4 




+5 




+6, 


+ 7 


+8, 


+9 



Stat — get file status 

sys Stat; name; buf / stat = 18. 

n ame points to a null-terminated string naming a 
file; buf is the address of a 34(10) byte buffer 
into which information is placed concerning the 
file. It is unnecessary to have any permissions 

tories leading to the file must be readable. 

After stat . buf has the following format: 



i -number 

flags (see below) 

number of links 

user ID of owner 

size in bytes 

first indirect block or contents block 



+22, +23 eighth indirect block or contents block 
+24, +25, +26, +27 creation time 
+28, +29, +30, +31 modification time 
+32, +33 unused 

The flags are as follows: 

100000 used (always on) 

040000 directory 

020000 file has been modified (always on) 

010000 large file 

000040 set user ID 

000020 executable 

000010 read, owner 

000004 write, owner 

000002 read, non-owner 

000001 write, non-owner 



fstat 

Error bit (c-bit) is set if the file cannot be 
found , 

The format is going to change someday. 

ken, dmr 
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SYS STIME (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



stime — set time 
(time in AC-MQ) 



ayts 



»t iuie 






stime sets the system's idea of the time and 
date. Only the super-user may use this call. 



SEE ALSO 
DIAGNOSTICS 

BUGS 
OWNER 



sys time 

Error bit (c-bit) set if user is not the super- 
user. 



ken, dmr 



11/3/71 



SYS STTY (II) 



NAME 
SYNOPSIS 

arg: 
DESCRIPTION 



stty — set mode of typewriter 

(file descriptor in rO) 
sys stty; arg 



atty = 31 • I iiOt ill aoseinljltsr 



dcrsr; dcpsr; mode 



stty sets mode bits for a typewriter whose file 






y-* ri e« t^ ^r\^ 



-n 






delays until the typewriter is quiescent. Then, 
the argument dcrsr is placed into the typewri- 
ter's reader control and status register, and 
d cpsr is placed in the printer control and status 
register. The DC-1 1 manual must be consulted for 
the format of these words. For^the purpose of 
this call, the most important role of these argu- 
ments is to adjust to the speed of the typewrit- 
er. 

The mode arguments contains several bits which 
determine the system's treatment of the 
typewriter: 

200 even (M3 7 tty) parity allowed 

100 odd (non-M37 tty) allowed 

040 raw mode: wake up on all characters 

020 map CR into LF; echo LF or CR as CR-LF 

010 don't echo (half duplex) 

004 map upper case to lower case on input (M33 TTY) 

Characters with the wrong parity, as determined 
by bits 200 and 100, are ignored. 

In raw mode, every character is passed back im- 
mediately to the program. No erase or kill pro- 
cessing is done; the end-of-file character (EOT), 
the interrupt character (DELETE) and the quit 
character (FS) are not treated specially. 

Mode 020 causes input carriage returns to be 
turned into new-lines; input of either CR or LF 
causes CR-LF both to be echoed (used for GE Ter- 
miNet 300's), 



SEE ALSO 
DIAGNOSTICS 

BUGS 



gtty 

The error bit (c-bit) is set if the file descrip- 
tor does not refer to a typewriter. 

This call should be used with care. It is all 
too easy to turn off your typewriter. 



OWNER 



ken, dmr 



11/3/71 



SYS TELL (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO. 

DIAGNOSTICS 

BUGS 
OWNER 



tell — get file pointer 

(file descriptor in rO) 

sys tell; offset; ptrnairie 

(value returned in rO) 






The file descriptor refers to an open tile. The 
value returned in rO is one of: 

if p trname is 0, the value returned is offset ; 

if ptrname is 1 , the value is the current 
pointer plus offset ; 

if p trname is 2, the value returned is the 
number of bytes in the file plus offset . 



seek 

The error bit (c-bit) is set if the file descrip- 
tor is unknown. 

Tell doesn't work. Complain if you need it. 
ken, dmr 
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SYS TIME ( \\) 



NAME 
SYNOPSIS 

DESCRIPTION 



time 



sys 

\ >. J.IIIC fid- 



get time of year 



time 



/ time = 13, 



time returns the time since 00:00:00, Jan. 1, 
1971, measured in sixtieths of a second. The 
high order word is in the AC register and the low 



rtrAair 



n 4-V.i 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



The chronological-minded user will note that 
2**32 sixtieths of a second is only about 2.5 
years. 



OWNER 



ken, dmr 
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SYS UMOUNT (II) 



NAME 

SWOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



umount — dismount file system 

sys umount; special / umount = 22,; not in assembler 

umount announces to the system that special file 
special is no longer to contain a removable file 
system. The file associated with the special 
file reverts to its ordinary interpretation (see 

The user must take care that all activity on the 
file system has ceased. 



mount 

Error bit (c-bit) set if no file system was 
mounted on the special file. 

Use of this call should be restricted to the 
super-user. 



QWNEK 



ken, dmr 
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SYS UNLINK (II) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



BUGS 



unlink. — remove directory entry 

sys unlink; name / unlink =10. 

Name points to a null-terminated string. Unlink 
removes the entry for the file pointed to by name 
from its directory. If this entry was the last 
link to the file, the contents of the file are 
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T-F 
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the file was open in any process, the actual des- 
truction is delayed until it is closed, even 
though the directory entry has disappeared. 



link 

The error bit (c-bit) is set to indicate that the 
file does not exist or that its directory cannot 
be written. Write permission is not required on 
the file itself. It is also illegal to unlink a 
directory (except for the super-user). 

Probably write permission should be x'equired to 
remove the last link to a file, but this gets in 
other problems (namely, one can donate an un- 
deletable file to someone else). 

If the system crashes while a file is waiting to 
be deleted because it is open, the space is lost. 



OWNER 



ken, dmr 
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SYS WAIT (II) 



NAME 
SYNOPSIS 

DESCRIPTION 



wait — wait for process to die 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



sys wait 
(process ID in rO) 



/ wait = 7. 



wait causes its caller to delay until one of its 
child processes terminates. If any child has 
already died, return is immediate! if there are 
no children, return is iuiinediate with the error 
bit set. In the case of several children several 
waits are needed to learn of all the deaths. 



fork 

error bit (c-bit) on 
ly waited for. 



if no children not previous- 



A child which dies but is never waited for is not 
really gone in that it still consumes disk swap 
and system table space. This can make it impos- 
sible to create new processes. The bug can be 
noticed when several "&" separators are given to 
the shell not follovTed by an command without an 
ampersand. Ordinarily things clean themselves up 
when an ordinary command is typed, but it is pos- 
sible to get into a situation in which no com- 
mands are accepted, so no waits are done; the 
system is then hung. 

The fix, probably, is to have a new kind of fork 
which creates a process for which no wait is 
necessary (or possible); also to limit the number 
of active or inactive descendants allowed to a 
process. 



OWNER 



ken, dmr 
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SYS WRITE (if) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



write — write, on file 



(file descriptor in rO) 
(number written in rO) 



/ t.""'»+*'=* — ^ 



A file desci^ptor is a word returned from a suc- 
cessful o pen or creat call. 

buffer is the address of nchars contiguous bytes 
which are written on the output file. The number 
of characters actually written is returned in rO. 
It should be regarded as an error if this is not 
the same as requested. 

For disk and tape files, writes which are multi- 
ples of 512 characters long and begin on a 
512-byte boundary are more efficient than any 
others . 



sys creat, sys open 

The error bit (c-bit) is set on an error: bad 
descriptor, buffer address, or count, physical 
I/O errors; 



ken, dmr 
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ATOF (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



atof — ascii to floating 



jsr 



r 5, atof; subr 



atof will convert an ascii stream to a floating 
number returned in frO. The subroutine subr is 
called on r5 for each character of the ascii 
stream, subr should return the character in rO. 



n'y^i 
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left in rO. The floating point simulation should 
be active in either floating or double mode, but 
in single precision integer mode. 

kept in /etc/liba.a 

fptrap 



The subroutine subr should not disturb any regis- 
ters. 



OV.'NER 



ken 
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ATOI (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



atoi — ascii to integer 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



jsr 



rS.atoi; subr 



atoi will convert an ascii stream to a binary 
number returned in mq. The subroutine subr is 

called on r5 for each character of the ascii 
stream, s ubr should return the character in rO, 
The first character not useu in tue conversion is 
left in rO. 

kept in /etc/liba.a 



The subroutine subr should not disturb any regis- 
ters . 



OVVNER 



ken 
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GTIME (III) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



ctime — convert date and time to ASCII 

(rriove time to AC-MQ) 
mov $buffer,rO 
jsr pc.ctim-e 

The buffer is 15 characters long. The time has 
the format 

Oct 9 17:32:24 

The input time is in the AC and MQ registers in 
the form returned by sys time . 

kept in /etc/liba.a 

ptimie, to print time; sys time 



The time is not taken modulo 1 year. (Jan 1 
comes out Dec 32.) Also, the clock period is only 

a ccuple cf years. 
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EXP (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



exp — exponential function 

jsr rS.exp 

The exponential of frO is returned in frO. The 
floating point simulation should be active in 
either floating or double mode, but in single 
precision integer mode, 

kept in /etc/liba.a 

fptrap 



Large arguments will cause an overflow fault from 
the floating point simulator. 



OWNER 



ken 



11/3/71 FPTRAP (III) 

NAME fptrap — floating point simulator 

SYNOPSIS sys 33. ; fptrap 

DESCRIPTION fptrap is a program designed to pick up illegal 

instruction in order to simulate a sub-set of the 
11/45 floating point hardware, 

FILES kept in /etc/liba.a 

SEE ALSO as, PDP-11/45 manual 

DIAGNOSTICS none, hardware gives no diagnostics. 

BUGS The sim^ulation, if unsuccessful for any reason 

gives an lOT fault from inside the simulator. 
This should be handeled better. 

OWNER ken, dmr 
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FTOA (III 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



ftoa — floating to ascii conversion 



jsr 



r 5, ftoa; subr 



ftoa will convert the floating point number in 
frO into ascii in the form [-J d, dddddddde [-] dd* . 
The floating point simulator should be active in 
either floating or double mode, but in single 



~S ■ 
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ftoa, the subroutine subr is called on register 
r5 with the character in rO. 

kept in /etc/liba.a 

fptrap 



The subroutine subr should not disturb any regis- 
ters. 



OWNER 



ken 



11/3/71 



GETW, GETC, FOPEN (ill) 



NAME 


getw, 


, getc, fopen 


SYNOPSIS 


mov 


$f ilename , rO 




jsr 


r5 J fopen: iobuf 




jsr 


r 5, getc; iobuf 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



>„i icij. cii- L-Ci in J- <J y 

jsr r5,getw; iobuf 
(word in rO) 

These routines are used to provide a buffered 
input facility. iobuf is the address of a 
134(10) byte buffer area whose contents are main- 
tained by these routines. Its format is: 



ioptr 



.=. + 2 
.=.+2 
.=.+2 
.=.+128. 



/ file descriptor 
/ characters left in buffer 
/ ptr to next character 
/ the buffer 



fopen should be called initially to open the 
file. On return, the error bit (c-bit) is set if 

will read from the standard input file. 

get c returns the next byte from the file in rO. 
The error bit is set on end of file or a read 
error. 

getw returns the next word in rO. getc and g etw 
may be used alternately; there are no odd/even 
problems, 

iobuf must be provided by the user; it must be on 
a word boundary, 

kept in /etc/liba,a 

sys open, sys read; putc, putw, fcreat 

c-bit set on EOF or error 

for greater speed, the buffer should be 512 bytes 
long. Unfortunately, this will cause several 
existing programs to stop working. 



OWNER 



dmr 
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ITOA (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



itoa — integer to ascii conversion 

jsr r 5, itoa; subr 

itoa will convert the number in rO into ascii 
decimal possibly preceded by a - sign. For each 
character generated by itoa, the subroutine subr 
is called on register r5 with the character in 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



kept in /etc/liba.a 



The subroutine subr should not disturb any regis- 
ters , 



OWNER 



ken 
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LOG (III) 



NAKE 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



log — logarithm base e 

jsr r5,log 

The logarithm base e of frO is returned in frO. 



either floating or double mode, but in single 
precision integer mode. 

kept in -/etc/liba.a 

fptrap 

The error bit (c-bit) is set if the input argu- 
ment is less than or equal to zero. 



ken 
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MESG (III) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 
DIAOSIOSTICS 
BUGS 

OWNER 



mesg — write message on typewriter 

jsr r5,mesg; <Now is the tiine\0>; .even 

mesg writes the string immediately following its 
call onto the standard output file. The string 
is terminated by a byte. 



k-^n1- in /e't'c/Tib? 
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ken. dmr 
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PTIME (III) 



NAME 
SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OwtN LK 



ptime — print date and time 

(move time to ac-mq) 

j sr pc , pt ime 

pt im e prints the date and time in the form 

Oct 9 17:20:33 

on the file whose file descriptor is in rO. The 
string is 15 characters long. The time to be 

printed is placed in the AC and MQ registers in 
the form returned by sys t ime . 

kept in /etc/liba.a 

sys time, ctime (used to do the conversion) 

see ctime 

drnr , ker: 
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PUTC, PUTW, FCREAT, FLUSH (III) 



NAME 
SYNOPSIS 



putc, putw, fcreat, flush — buffered output 



DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



mov 
jsr 



Of ilename ,rO 



(get byte in rO) 

jsr r5,putc; iobuf 

jsr r 5, putw; iobuf 

jsr r5, flush; iobuf 

fcreat creates the given file (mode 17) and sets 
up the buffer i obuf (size 134(10) bytes); put c 
and putw write a byte or word respectively onto 
the file; flush forces the contents of the buffer 
to be written, but does not close the file. The 

■F(-^T-ma+- /-.-F t-Vio >MTF-Fpr- i <s • 



iobuf: .=,+2 
.=.+2 
.=. + 2 
.-.+128, 



/ file descriptor 

/ characters unused in buffer 

/ ptr to next free character 
/ but 1 er 



fcreat sets the error bit (c-bit) if the file 
creation failed; none of the other routines re- 
turn error information . 

Before terminating, a program should call flush 
to force out the last of the output. 

The user must supply iobuf , which should begin on 
a word boundary. 

kept in- /etc/liba.a 

sys creat; sys write; getc, getw, fopen 

error bit possible on fcrea t call 

buffers should be changed to 512 bytes. 

dmr 
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SIN, COS (III) 



NAME 

SYNOPSIS 

DESCRIPTION 



sin, cos 



sine cosine 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



jsr 



r5,sin (cos) 



The sine (cosine) of frO (radians) is returned In 
trO. The floating point simulation should be 

active in either floating or double mode, but in 
single precision integer mode. All floating 

_--, — _ — — «_», — », 

kept in /etc/liba.a 
fptrap 



Size of the argument should be checked to make 
sure the result is meaninq-ful. 



OWNER 



ke n . dmr 
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NAME switch — switch on value 

SYNOPSIS (switch value in rO) 

J M «- ■v- C ^^T.T^ +• ^^ V\ • ^T.T+- a Vi 

(not-found return) 

• • • 

swtab: val1 ; lab1 ; 
. . • 

, »... , — 

. . ; 

DESCRIPTION switch compares the value of rO against each of 

the val, ; if a match is found, control is 
transferred to the corresponding lab^ (after pop- 
ping the stack once). If no match has been found 
by the time a null lab. occurs, switch returns. 

FILES kept in /etc/liba.a 

SEE ALSO 

DIAGNOSTICS 

BlJCiS — 

OWNER ken. dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



mem — core memory 



mem maps the core memory of the computer into a 
file. It may be used, for example, to examine, 
and even to patch the system using the debugger. 

M^n is a byte— oriented file; its bytes are num- 
bered to 65,535. 



OWNER 



If a location not corresponding to implemented 
memory is read or written, the system will incur 
a bus-error trap and, in panic, will reboot it- 
self. 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



ppt — punched paper tape 



ppt refers to the paper tape reader or punch, 
depending on whether it is read or written. 

When ppt is opened for writing, a 100-character 
leader is punched. Thereafter each byte written 
is punched" on the tape. No editing of the char- 
acters is performed. When the file is closed, a 
100-character trailer is punched. 

When ppt is opened for reading, the process waits 
until tape is placed in the reader and the reader 
is on-line. Then requests to read cause the 
characters read to be passed back to the program, 
again without any editing. This means that 
several null characters will usually appear at 
the beginning of the file; they correspond to the 
tape leader. Likewise several nulls are likely 
to appear at the end. End-of-file is generated 
when the tape runs out. 

Seek calls for this file are meaningless and are 
effectively ignorea ^nowever, the read/wi-iLe 
pointers are maintained and an arbitrary sequence 
of reads or writes intermixed with seeks will 
give apparently correct results when checked with 
tell ) . 



Ibppt, dbppt, bppt format 



Previously, there were separate special files for 
ASCII tape (which caused null characters to be 
suppressed) and binary tape (which used a blocked 
format with checksums). These notions were con- 
ceptually quite attractive, but they were dis- 
carded to save space in the system. 



OWNER 



ken- dm.r 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



rfO — RF11-RS11 fixed-head disk file 



This file refers to the entire RF disk. It may 
be either read or written, although writing is 
inherently very dangerous, since a file system 
resides there. 

The disk contains 1024 2 56-word blocks, numbered 
to 1023. Like the other block-structured dev- 
ices (tape, RK disk) this file is addressed in 
blocks, not bytes. This has two consequences: 
seek calls refer to block numbers, not byte 
numbers; and sequential reading or writing always 
advance the read or write pointer by at least one 
block. Thus successive reads of 10 characters 
from this file actually read the first 10 charac- 
ters from successive blocks. 



/dev/tapO, /dev/rkO 



The fact that this device is addressed in terms 
of blocks, not bytes, is extremely unfortunate. 
It is due entirely to the fact that read and 
write pointers (and consequently the arguments to 
seek and tell ) are single-precision numbers. 
This really has to be changed but unfortunately 
the repercussions are serious. 



OWNER 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWMER 



rkO — RK03 (or RK05) disk 



rkO refers to the entire RK03 disk as a single 
sequentially-addressed file. Its 256-word blocks 
are numbered to 4871 . Like the RF disk and the 
tape files, its addressing is block-oriented. 



/dev/rfO, /dev/tapO 

See /dev/rfO 
ken, dmr 
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TAP7 (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 
UiAGNUbTiCb 

BUGS 
OWNER 



tapO . . . tap? 



These files refer to DECtape drives to 7 . 
Since the logical drive number can be manually 
set, all eight files exist even though at present 
there are only two physical drives. 

The 256-word blocks on a standard DECtape are 
numbered to 577. However, the system makes no 
assumption about this number; a block can be read 
or written if it exists on the tape and not oth- 
erwise. An error is returned if a transaction is 
attempted for a block which does not exist. 

Like the RK and RF special files, addressing on 
the tape files is block-oriented. See the RFO 
section. 



/dev/rfO, /dev/rkO 

see /dev/rfO 
ken, dmr 



11/3/71 



/DEV/TTY (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



tty — console typewriter 



tty (as distinct from ttyO . ,.., ttyS ) refers to 
the console typewriter hard-wired to the pDjf-l 1 . 
Most of the time it is turned off and so has lit- 
tle general use. 

Generally, the disciplines involved in dealing 
with tty are similar to those for ttyO ... and 
the appropriate section should be consulted. The 
following differences are salient; 

The system calls stty and gtty do not apply to 
this device. It cannot be placed in raw mode; on 
input, upper case letters are always mapped into 
lower case letters; a carriage return is echoed 
when a line-feed is typed. 

The quit character is not FS (as with^tt^Q . . . ) ,, 
but is generated by the key labelled "alt mode. 

By clppi Opi A <ate v^wiisuic owius-u o — wwJ.ijyi=, J-- j-a 

possible to cause UNIX to come up as a single- 
user system with I/O on this device. 



/dev/ttyO. . . ; init 



ken, dmr 
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TTY5 (IV) 



NAME 

SYNOPSIS 

DESCRIPTION 



ttyO ... tty5 — communications interfaces 



These files refer to DC1 1 asynchronous communica- 
tions interfaces. At the moment there are six of 
them, but the number is subject to change. Names 
for up to four others will be constructed by an 
obvious alaorithm. 



When one of these files is opened, it causes the 
process to wait until a connection is esta- 
blished. (In practice, however, user's programs 
seldom open these files; they are opened by ini t 
and become a user's standard input and output 
file.) The very first typewriter file open in a 
process becomes the control typewriter for that 
process. The control typewriter plays a special 
role in the handling quit or interrupt signals, 
as discussed below. The control typewriter is 
inherited by a child process during a forlc . 

A terminal associated with one of these files 

ters may be typed at any time, even while output 
IS occurring, and are onxy lost when tne system' s 
character input buffers become completely choked, 
which is very rare. 

When first opened, the interface expects the ter- 
minal to use 15 odd-parity, 10-bit ASCII charac- 
ters per second and to have the new-line func- 
tion. Finally, the system calculates delays 
after sending the code for certain functions 
(e.g., new-line, tab) on the assumption that the 
terminal is a Teletype model 37. All this is 
merely a long way of saying that the system ex- 
pects to be used by a TTY 37. However, most of 
these assumptions can be changed by a special 
system call: in particular, the expected parity 
can be changed; the speed, character size, and 
stop bits can be changed (speeds available are 
134.5, 150, 300, 1200 baud; see the DC 11 manual); 
the new-line function can be simulated by a com- 
bination of the carriage-return and line-feed 
functions; carriage return can be translated into 
new-line on input; upper case letters can be 
mapped into lower case letters; echoing can be 
turned off so the terminal operates in half du- 
plex. See the system call stty . (Also see init 
for the way 300-baud terminals are detected.) 

Normally, a typewriter operates in units of 
lines. This means that a program attempting to 
read will be suspended until an entire line has 
been typed. Also, no matter how many characters 
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are requested in the read call, at most one line 
will be returned. It is not however necessary to 
read a whole line at once; any number of charac- 

without losing information. 

The EOT character may be used to generate an end 
of file from a typewriter. When an EOT is re- 
ceived, all the characters waiting to be read are 
immediately passed to the program, without wait- 
ing for a new-line. Thus if there are no charac- 
ters waiting, which is to say the EOT occurred at 
the beginning of a line, zero characters will be 
passed back, and this is the standard end-of-file 
signal. 

When the carrier signal from the dataset drops 
(usually because the user has hung up his termi- 
nal) any read returns with an end-of-file indica- 
tion. Thus programs which read a typewriter and 
are sensitive to end-of-file on their inputs 
(which all programs whould be) will terminate 
appropriately when hung up on. 

Two characters have a special meaning when^typed. 
The__ASCII DEL character {, sometimes caiiea "ruD- 
out" ) is the i nter rupt signal. When this charac- 
ter is received from a given typewriter, a search 
is made for all processes which have this type- 
writer as their control typewriter, and which 
have not informed the system that they wish to 
ignore interrupts. If there is more than one 
such process, one of these is selected, for prac- 
tical purposes at random. Then either the pro- 
cess is forced to exit or a trap is simulated to 
an agreed-upon location in the process. See sys 
intr for more information. 

The ASCII character FS is the quit signal. Its 
treatment is identical to the interrupt signal 
except that unless the receiving process has made 
other arrangements it will not only be terminated 
but a core image file will be written, (See sys 
quit for more information.) 

During input, erase and kill processing is nor- 
mally done. The character '*# erases the last 
character typed, except that it will not erase 
beyond the^^beginning of a line or an EOF. The 
character "©*' kills the entire line up to the 
point where it was typed, but not beyond an EOF. 
Both these characters operate on a keystroke 
basis independently of any backspacing or tabbing 
that may have been done. Either "@" or "#" may 
be entered literally by preceding it by "\" j^ the 
erase or kill character remains, but the \ 
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TT!f5 {IV) 



disappears. 

It is also possible (again by s^ stty) to put 

W><:> t-iTr\a\^yi *• or- in-hz-i raw mri{i«a . Tn hVlis mod ft . tVlfi 

program reading is wakened on each character, and 
when a program reads, it waits only until at 
least one character has been typed. In raw mode, 
no erase or kill processing is done; and the EOT, 
auit and interruot characters are not treated 
specially. 

Output is prosaic compared to input. It should 
be noted, however, that when one or more charac- 
ters are written, they are actually transmitted 
to the terminal as soon as previously-written 
characters have finished typing. When a program 
produces characters too rapidly to be typed, as 
is very common, it may be suspended for a time. 

Odd parity is always generated on output, except 
that the characters EOT and NAK have the wrong 
parity. Thus the 37 TTY will not hang up (EOT) 
or lock its keyboard (NAK) if a program acciden- 



FiLKS 
SEE ALSO 
DIAGNOSTICS 
BUGS 



OWNER 



tty 



As has been suggested, UNIX has a heavy predispo- 
sition towards 37 Teletype terminals. However, 
it is quite possible to use 300-baud terminals 
such as the GE TerraiNet 300. (See inlt for the 
procedure.) The main difficulty in practice is 
37-oriented delay calculations. 

Terminals such as the IBM 2741 would theoretical- 
ly be very desirable but there are many difficul- 
ties related to its inadequate and non-ASCII 
character sets (the 2741 has two, count 'em) and 
the inherently half-duplex nature of the termi- 
nal. It is possible to produce output on a 2741 ; 
cf type, 

ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



a. out 



assembler and link editor output 



a^out is the output file of the assembler as and 
the link editor 1^. In both cases, a. out is exe- 
cutable provided there were no errors and no 
unresolved external references. 

This file has four sections: a header, the pro- 
gram text, a symbol table, and relocation bits. 
The last two may^^be^empty if the program was 
loaded with the "-s" option of Id or if the sym- 
bols and relocation have been removed by strip . 

The header always contains 6 words: 

1 a "br .+14" instruction (205(8)) 

2 The size of the program text 

3 The size of the symbol table 

4 The size of the relocation bits area 

5 The size of a data area 

6 A zero word (unused at present) 

The sizes of the program, symbol table, and relo- 
cation area are in bytes but are always even. 
The branch instruction serves both to identify 
the file and to jump to the text entry point. 
The program text size includes the 6-word header. 

The data area is used when the file is executed; 
the exec system call sets the program break to 
the sum of the text size and this data size. The 
data area is generated by the assembler when the 
location counter "." lies beyond the last assem- 
bled data, for example when the program ends^with 
one or more constructions of the form .=.+n ; it 
is preserved by the loader for the last program 
in a load. (Routines other than the last have 
the appropriate number of words inserted, since 
there is no other provision for zero- suppress ion 
in an a. out file.) 

The symbol table consists of 6-word entries. The 
first four contain the ASCII name of the symbol, 
null-padded. (In fact, the assembler generates 
symbols of at most 7 bytes.) The next word is a 
flag indicating the type of symbol. The follow- 
ing values are possible: 

GO undefined symbol 

01 absolute symbol 

02 register symbol 

03 relocatable symbol 

40 undefined global symbol 

41 absolute global symbol 
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43 relocatable global symbol 

An undefined global corresponds to a GMAP "sym- 
ref and an absolute or relocatable global to a 
"symdef" or absolute or relocatable value respec- 
tively. Values other trian tbose given above inay 
occur if tbe user bas defineia some Oi. hj-s own 
instructions. 

The last word of a symbol table entry contains 
the value of the symbol. Its contents are not 
specified if the symbol is undefined. 

If a. out contains no unresolved global refer- 
ences, header and text portions are exactly as 
they will appear in core when the file is execut- 
ed. If the value of a word in the text portion 
involves a reference to an undefined global, the 
word is replaced by the offset in the symbol 
table of the appropriate symbol, (That is, pos- 
sible offsets are 0, 12(10), 24(10), ,,,,) Such a 
word will have appropriate relocation bits. 

The relocation bits pC'Ttion uses a variable- 
length encoding. There is a string of bits for 
each word xn the text portion. The scrieme has aL 
least two bits for each word, plus possibly two 
more to extend the codes available; in either 
case the bits may be followed by a 16-bit string 
to represent an offset to an external symbol. 
The bits are packed together without regard to 
word boundaries. The last word is filled out 
with O's on the right. 

The possible relocation bit configurations are: 

00 

word is absolute 

01 

word is relocatable 

10 

word is a relative reference to an undefined 
global symbol with no offset. Currently, the 
word contains the offset in the symbol table 
of the symbol. When the symbol becomes de- 
fined, say with value Xj^ this location will 
contain x-.-2, where " , is the location of 
the word. 

1 1 OOxxxxxxxxxxxxxxxx 

word is a relative reference to an external 
symbol with an offset. It is the same as the 
previous relocation type, except that the 
16-bit offset is added in when the symbol 
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becomes defined. 
1101 

*.T<-\v-y^ A ^ a v» £i^ ^ v^v\ (-•ti ^r^ a«^ nn/^ £i^ t r* ^/^ £!%/+• firr^ ;*T 

symbol with no offset. At present the word 
contains the symbol table offset of the sym- 
bol, when the symbol becomes defined, the 
word will contain the value of the symbol. 

ill Oxxxxxxxxxxxxxxxx 

word is a reference to an undefined external 
symbol with an offset. At present, the word 
contains the symbol table offset of the sym- 
bol. When the symbol becomes defined, the 
word will contain the value of the symbol 
plus the given 16-bit offset. 



FILES — 

SEE ALSO as Id, strip , nm . un 

DIAGNOSTICS 

BUGS Soon, there will be a new type of' symbol; the 

data area symbol, m tne text, it will appear as 
an ordinary external reference. However, it need 
not be defined; this will be done by the loader. 
Watch this space for more details. 

OWNER dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE AX.SO 

DIAGNOSTICS 

BUGS 

OWNER 



archive (library) file format 



The archive command ax is used to combine several 
files into one. Its use has three benefits: when 
files are combined, the file space consumed by 
the breakage at the end of each file (256 bytes 
on the average) is saved; directories are smaller 
and less confusing; archive files of object pro- 
grams may be searched as libraries by the loader 
Id. 

A file produced by ar has a "magic number" at the 
start, followed by the constituent files, each 
preceded by a file header. The magic number is 
-147(10), or 177555(8) (it was chosen to be un- 
likely to occur anywhere else). The header of 
each file is 16 bytes long: 

0-7 

file name, null padded on the right 

8-11 

Modification time of the file 



12 



13 



User ID of file owner 



file mode 



14-15 

file size 

If the file is an odd nxomber of bytes long, it is 
padded with a null byte, but the size in the 
header is correct. 

Notice there is no provision for empty areas in 
an archive file. 



ar. 



Id 



ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



binary punched paper tape format 



Binary paper tape* is used to pass and store arbi- 
trary information on paper tape. The format 
chosen has the following features: a) no format 
of the data is assumed. b) check summing c) zero 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



The format is as follows: 

Between records, NULL characters are ignored. 
The beginning of the tape is considered between 
records, thus the leader is ignored. 

The first non-null character specifies the type 
and size of the record. If the character is 
positive (1 to 177), the record is a data record 
consisting of that many characters. All but the 
last of these characters are data, the last being 
a checksum. The checksum is calculated such that 
the sum of the entire record is zero mod 256. 

If the first character is negative (200-376) the 
record is a zero suppression record. It is 
identical to minus that number of zeros of data. 
One character of checksum follows this negative 
character. It is the positive of the negative 
character. 

The special case of a record looking like a sin- 
gle zero character suppressed (377;1 ) causes no 
data transfer, but is an end-of-file indication. 



Ibppt , dbppt 



ken , drar 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 



format of core image 



Three conditions cause UNIX to write out the core 



^ -t: — 



pjuwy i. aiti; 









iractge oj. an cxei-u uxiiy 

erates an unexpected ui.ap vwy a uus exivJi 
illegal instruction); the user sends a "quit" 
signal (which has not been turned off by the 
program); a trap is simulated by the floating 
point simulator. The core image is called "core 
and is written in the current working directory 
(provided it can be; normal access controls ap- 
ply). It is exactly 8192+64 bytes long. The 
first 8192 represent the actual contents of 
memory at the time of the fault; the last 64 are 
the contents of the system's per-user data area 
for this process. Only the first word of this 
area will be described. 

When any trap which is not an l/o interrupt oc- 
curs, all the useful registers are stored on the 
stack. After all the registers have been stored, 

nf t-he user area; this cell is called u. sp . 
ihereilure, wichin uiie sjui c xiuayc piwpai, Lxiei <= xS 
an area which contains the following registers in 
the following order (increasing addresses): 

(u.sp)->sc 
mq 
ac 
r5 
r4 
r3 
r2 
r1 
rO 

pc (at time of fault) 
processor status (at time of fault) 

The last two are stored by the hardware. It fol- 
lows that the contents of s£_ at the time of the 
fault were (u.sp) plus 22(10). 

The t-bit (trap bit) in the stored status will be 
on when a quit caused the generation of the core 
image, since this bit is used in the implementa- 
tion of quits. 
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BUGS 

OWNER ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



format of directories 



A directory behaves exactly like an ordinary 
file, save that no user may write into a directo- 
ry. The fact that a file is a directory is indi- 
cated by a bit in the flag word of its i-node 

pnt rv - 
^ « 

Directory entries are 10 bytes long. The first 
word is the i-node of the file represented by the 
entry, if non-zero; if zero, the entry is empty. 

Bytes 2-9 represent the ( 8-character) file name, 
null padded on the right. These bytes are not 
necessarily cleared for empty slots. 

By convention, the first two entries in each 
directory are for "." and ".,". The first is an 
entry for the directory itself. The second is 
for the parent directory. The meaning of ".." is 
modified for the root directory of the master 
file system and for the root directories of re- 
movable file systems. In the first case, there 
is no parent, and in the second, the system does 
not permit off-device references without a mount 

JT tff tf ————— 



system call. Therefore in both cases 
the same meaning as . . 



file system format 



has 



ken, drar 
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NAME 

SYNOPSIS 

DESCRIPTION 



format of file system 



Every file system storage volxime (e.g. RF disk, 
RK disk DECtape reel) has a common format for 
certain vitsl information - 



£,v e JL y s ucli vvj j. ums 



/^£»-»--f- a ^ 



n 



number of 256 word (512 byte; blocks. BIocks u 
and 1 are collectively known as the super - block 
for the device; they define its extent and con- 
tain an i-node map and a free- storage map. The 
first word contains the number of bytes in the 
free-storage map; it is always even. It is fol- 
lowed by the map. There is one bit for each 
block on the device; the bit is "l" if the block 
is free. Thus if the number of free-^nap bytes is 
n, the blocks on the device are numbered 
through 8n-1 . The free-map count is followed by 
the free map itself. The bit for block k of the 
device is in byte k/8 of the map; it is offset 
k(mod 8) bits from the right. Notice that bits 
exist for the superblock and the i-list, even 
though they are never allocated or freed. 

After the free map is a word containing the byte 
count for the i-node map. It too is always even. 
I-numbers below 41(10) are reserved for special 
files, and are never allocated; the first bit in 
the i-node free map refers to i-number 41. 
Therefore the byte number in the i-node map for 
i-node i is (i-41)/8. It is offset (i-41 ) (mod 
8)^^bits from the right; unlike the free map, a 
"o" bit indicates an available i-node. 

I-numbers begin at 1 , and the storage for i-nodes 
begins at block 2. Also, i-nodes are 3 2 bytes 
long, so 16 of them fit into a block. Therefore, 
i-node i is located in block (i.+ 31 )/16 of the 
file system, and begins 32* ( (i+31 ) (mod 16)) bytes 
from its start. 

There is always one file system which is always 
mounted; in standard UNIX it resides on the RF 
disk. This device is also used for swapping. 
The swap areas are at the high addresses on the 
device. It would be convenient if these ad- 
dresses did not appear in the free list, but in 
fact this is not so. Therefore a certain niomber 
of blocks at the top of the device appear in the 
free map, are not marked free, yet do not appear 
within any file. These are the blocks that show 
up "missing" in a check of the RF disk. 

Again on the primary file system device, there 
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are several pieces of information following that 
previously discussed. They contain basically the 
information typed by the tm command; namely, the 
times spent since a cold boot in various ca- 
tegories, and a count of I/O errors. In particu- 

l:a>- 4-T«^^v»^ :av»^ ■^ r.T/"> t.t^^ v /^ et t.7 ^^V» ^V»e ^^al avs /fl a v* ^ 4 tv» /-^ 

(m^aonvOi-^ c ^ T\ r*^ CiCi • C\ r\ .Tar\ 1 i Q*7 i 1 • 4-r.7/-> t*t/-«. T^y^ c 

with the time spent executing in the system; two 
words with the time spent waiting for l/O on the 
RF and RK disks; two words with the time spent 
executing in a user's core; one byte with the 
count of errors on the RF disk; and one byte with 
the count of errors on the RK disk. All the 
times are measured in sixtieths of a second. 

I-node 41(10) is reserved for the root directory 
of the file system. No i-numbers other than this 
one and those from 1 to 40 (which represent spe- 
cial files) have a built-in meaning. Each i-node 
represents one file. The format of an i-node is 
as follows, where the left column represents the 
offset from the beginning of the i-node: 

0—1 "^ "^ acT s ( s e^^ below '^ 

2 number of links 

-! uSci ±iJ O £. OWn6:i 

4-5 size in bytes 

6-7 first indirect block or contents block 

• • • 

20-21 eighth indirect block or contents block 

22-25 creation time 

26-29 modification time 
30-31 unused 

The flags are as follows: 

100000 i-node is allocated 

040000 directory 

020000 file has been modified (always on) 

010000 large file 

000040 set user ID on execution 

000020 executable 

000010 read, owner 

000004 write, owner 

000002 read, non-owner 

000001 write, non-owner 

The allocated bit (flag 100000) is believed even 
if the i-node map says the i-node is free; thus 
corruption of the map may cause i-nodes to become 
unallocatable, but will not cause active nodes to 
be reused. 

Byte number n of a file is accessed as follows: n 
is divided by 512 to find its logical block 
number (say b) in the file. If the file is small 
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(flag 010000 is 0), then b must be less than 8, 
and the physical block number corresponding to b 
is the bth entry in the address portion of the 






If the file is large, b is divided by 2d6 to 
yield a number which must be less than 8 (or the 
file is too large for UNIX to handle). The 
corresponding slot in the i-node address portion 
gives the physical block number of an indirect 
block. The residue mod 256 of b is multiplied by 
two (to give a byte offset in the indirect block) 
and the word found there is the physical address 
of the block corresponding to b. 

If block b in a file exists, it is not necessary 
that all blocks less than b exist, A zero block 
number either in the address words of the i-node 
or in an indirect block indicates that the 
corresponding block has never been allocated. 
Such a missing block reads as if it contained all 
zero words. 



flLiiS 
SEE ALSO 
DIAGNOSTICS 
BUGS 

OWNER 



format ot ctirectories 



Two blocks are not enough to handle the i- and 
free-storage maps for an RP02 disk pack, which 
contains around 10 million words. 



2=/ , 
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7n 
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id 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



passwd — password file 



jasswd contains for each user the following 



intormation; 

name (login name) 

inssRwnrd 

numerical user ID 
default working directory 
program to use as Shell 

This is an ASCII file. Each field within each 
user's entry is separated from the next by a 
colon. Each user is separated from the next by a 
new-line. If the password field is null, no 
password is demanded; if the Shell field is null, 
the Shell itself is used. 

This file, naturally, is inaccessible to anyone 
but the super-user. 



This fiii 



/etc/init 



■esides in direcLory /etc. 



super-user 



11/3/71 



UIDS (V) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



/etc/uids — map user names to user IDs 



This file allows programs to map user names into 
user numbers and vice versa. Anyone can read it. 
It resides in directory /etc, and should be up- 
dated along with the password file when a user is 

added Or deleted. 

The format is an ASCII name, followed by a colon, 
followed by a decimal ASCII user ID number. 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



/trap/utmp — user information 



This file allows one to discover information 
about who is currently using UNIX. The file. is 
binary; each entry is 16(10) bytes long. The 
first eight bytes contain a user's login name or 

avA »^ii11 •{ -f ♦-VkO ♦•alalia eT/-\t- 4» nv-sticAi^ TtV*^ 1 *-»r * 

order byte of the next word contains the last 
character of a typewriter name (currently, '0' to 
'5' for /dev/ttyO to /dev/tty5). The next two 
words contain the user's login time. The last 
word is unused. 

This file resides in directory /tmp. 



/etc/init, which maintains the file. 



ken, dmr 
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BASIC (VI) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

OWNER 



basic — DEC supplied BASIC 
basic [file] 

Basic is the standard BASIC VOOO distributed as a 
stand alone program. The optional file argument 
is read before the console. See DEC-1 1 -AJPB-D 
manual , 

Since bas is smaller and faster, basic is not 
maintained on line. 



bas 

See manual 

GQK 

dmr 
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NAME bj — the game of black jack 

SYNOPSIS /usr/games/bj 

DESCRIPTION Black jack is a serious attempt at simulating the 

dealer in the game of black jack (or twenty-one) 
as might be found in Reno , 

The following rules apply: 

The bet is $2 every hand. 

A player 'natural' (black jack) pays $3. A 
dealer natural loses $2. Both dealer and 
player naturals is a 'push' (no money ex- 
change). 

If the dealer has an ace up, the player is 
allowed to make an 'insurance' bet against the 
chance of a dealer natural. If this bet is 
not taken, play resumes as normal. If the bet 
is taken, it is a side bet where the player 
wins $2 if the dealer has a natural and loses 
$1 if the dealer does not, 

it the player is uealL two caiUs of the Sctiae 
value, he is allowed to 'double'. He is al- 
lowed to play two hands, each with one of 
these cards. (The bet is doubled also; $2 on 
each hand. ) 

If a dealt hand has a total of ten or eleven, 
the player may 'double down'. He may double 
the bet ($2 to $4) and receive exactly one 
more card on that hand. 

Under normal play, the player may 'hit' (draw 
a card) as long as his total is not over 
twenty-one. If the player 'busts' (goes over 
twenty-one), the dealer wins the bet. 

When the player 'stands' (decides not to hit), 
the dealer hits until he attains a total of 
seventeen or more. If the dealer busts, the 
player wins the bet. 

If both player and dealer stand, the one with 
the largest total wins. A tie is a push. 

The machine deals and keeps score. The following 
questions will be asked at appropriate times. 
Each question is answered by y. followed by a new 
line for 'yes', or just new line for 'no'. 

? means 'do you want a hit?' 
Insureance? 
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DDuble down? 



Every time the deck is shuffled, the dealer so 
states and the 'action' (total bet) and 'stand- 
ing' (total won or loss) is printed. To exit, 
hit the interrupt key (DEL) and the action and 
standing will be printed. 



SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



cal — print calendar 

/usr/ken/cal year 

cal will print a calendar for the given year. 
The year can be between (really 1 BC) and 9999, 
For years when several calendars were in vogue in 
different countries, the calendar of England (and 
therefore her colnni^s^ is orini-^vs 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



P.S. try cal of 1752. 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



chess — the game of chess 

/usr/games/chess 

Chess is an attempt at computer chess. The pro- 
gram 'speaks' in algebraic chess notation. The 
initial board configuration in this notation is 
as follows: 
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A move is specified by the 'from' co-ordinate 
followed by the 'to' co-ordinate. Thus the white 
P-K4 move would be 'e2e4'. The black P-K4 would 
be 'e7e5'. 

The following commands are recognized by the 
chess program; 

move 

Make the move if legal. The program does not 
keep track of who is to play. The move is 
made for what ever side is specified. 

move X 

Make the move regardless of legality. This is 
a good way to either set up a desired situa- 
tion or to cheat. The initial move 'e2e8x' is 
a winner. 



mw 



The program will compute and make a move for 
the white pieces. 



m 



The program will compute and make a move for 



lab 



Set the level parameters to a and b, where a 
and b are numbers between and 9. The ini- 
tial settings are 2 and 8. The first parame- 
ter increases computation time rapidly while 
the second parameter only increases computa- 
tion exponentially. Currently move times run 
from 20 seconds to 10 minutes. It was hoped 
that these numbers would be usefully related 
to the program's competence. 
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The board is printed. 

u 

The last move is un-made. This is another 
qood way to cheat. 



Ax± tne moves to aare are print ea. 



The current game situation is saved on the 
file c.tmp. 



The game situation on the file c.tmp is re- 
stored, 

: command 

The Unix command is executed by the mini- 
shell. 

An interrupt (DEL) will pull the program out of 
its computation. If it is trying to make a move, 
the best move to date Is made. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 



C.tmp 

msh 

? if an illegal move is attempted, or if an un- 
known command is typed. 

The current version does not recognize castling, 
promotion and en passant, A new version is in 
the mill. 



OWNER 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



das — disassembler 



A PDP-11 disassembler exists, 
for more information. 



Contact the author 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



dli — load DEC binary paper tapes 
dli output [input] 

dli will load a DEC binary paper tape into the 
output file. The binary format paper tape is 
read from the input file (/dev/ppt is default, ) 

/dev/not 



checksum 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



dpt — read DEC ASCII paper tape 

dpt output [input] 

dpt reads the input file (/dev/ppt default) as- 
suming the format iS a DEC generated ASCII paper 
tape of an assembly language program. The output 
is a UNIX ASCII assembly program. 

/dev/ppt 



Almost always a hand pass is required to get a 
correct output. 



OWNER 



ken , dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



moo — a game 

/usr/games/moo 

moo is a guessing game imported from England, 



DIAGNOSTICS 

BUGS 

OWNER 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



sort — sort a file 

sort input output 

sort will sort the input file and write the sort- 
ed file on the output file. Wide options are 
available on collating sequence and ignored char- 
acters. 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



dmr, ken 
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NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS . 
OWNER 



ttt — tic-tac-toe 
/usr/games/ttt 



ttt is the X's and O's the L s- popular in 1st 
grade. This is a learning program that never 
makes the same mistake twice. 

ttt.k — old mistakes 



ken 
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NAME 


as 2 - 


SYNOPSIS 


— 


DESCRIPTION 


as2 is 




second 


FILES 


see as 


SEE ALSO 


as 


DIAGNOSTICS 


see as 


BUGS 


— 


OWNER 


dmr 



as2 — assembler pass 2 



a32 is invoked by the assembler as to perform its 



11/3/71 



/ETC/ASCII (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



ascii — roap of ASCII character set 

cat /etc/ascil 

ascii is a map of the ASCII character set, to be 
printed as needed. It contains: 
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SEE ALSO 






— 
























DIAGNOST] 


[CS 




~ 
























BUGS 








~ 
























OWNER 






jfo 

























11/3/71 



/ETC/BA (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



ba — B assembler 

/etc/ba name 

ba is invoked by the B command in order to turn 
the B intermediate code into assembly language. 

naroe.i (input), name.s (output) 

b command, /etc/be 



At the moment, the b command is defunct, and ba 
is invoked via a command file. 



OWNER 



ken 
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/ETC/BC (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 

FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



be — B compiler 

/etc/be name.b name.i 

be is the B compiler proper; it turns B source 
Into internieciiate coue* It is invokeu froui tut 
command* 

name.b (input), name.i (intermediate output) 

b (command) , /etc/ba 



The b command is defunct at the moment; be is 
called from a command file. 



OWNER 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



bilib — B interpreter library 



bilib is the library of B runtime operators. It 
is searched during the loading of a'B-compiled 
program. 

Standard B subroutines are contained in 
/etc/libb.a. 



b ( command ) ; ar , Id 



The following assignment binary operators are 
missing: b1 02 ( = 1), b1 03 (=&), b1 04 (===), b1 05 
( = ! = ), b106 (=<=), bl07 (=<), bllO (=>=), b1 1 1 
( = », b112 (=»), b113 (=«), b120 (=/). 



OWNER 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



bos, maki, rom, vcboot, msys , et al 



On the RF disk, the highest 1 6K words are 
reserved for stand-alone programs. These 1 6K 
words are allocated as follows; 



bos 

warm UNIX 
Cold UNIX 
Unas signed 



(IK) 
(6K) 
(6K) 
(3K) 



The UNIX read only memory (ROM) is home cut with 
2 programs of 1 6 words each. The first (address 
173700) reads bos from the RF disk into core 
location 54000 and transfers to 54000. The other 
ROM program (address 173740) reads a DEC tape sit- 
ting in the end-zone on drive into core loca- 
tion and transfers to 0. This latter operation 
is compatible with part of DEC's standard ROM. 
The disassembled code for the UNIX ROM follows : 



1 T7nn 

1 2740;3 

1 2740 ;1 40000 

12740; 54000 

12740; 176000 

12740;5 

105710 

2376 

137; 54000 

12700;177350 

5040 

10040 

12740;3 

105710 

2376 

5737;177350 

1377 

112710;5 

105710 

23-/6 

5007 



The program bos (Bootstrap Operating System) 
examines the console switchs and executes one of 
several internal programs depending on the set- 
ting. If no setting is recognizable, bos loops 
waiting for a recognizable setting. The follow- 
ing settings are currently recognized: 



173 700 s rr.ov 


$177472, rO 


mov 


$3,-(rO) 


mov 


9l4u000,-vrQ) 


mov 


$54000, -(rO) 


mov 


$-2000, -(rO) 


mov 


$5,-(r0) 


tstb 


(rO) 


bge 


.-2 


jmp 


♦$54000 


173740: mov 


$177350, rO 


clr 


-(rO) 


mov 


rO,-(rO) 


mov 


$3,-(rO) 


tstb 


(rO) 


bge 


.-2 


tst 


♦$177350 


bne 


• 


movb 


$5,(r0) 


tstb 


(rO) 


bge 


.-2 


clr 


pc 



173700 
73700 



Will read Warm UNIX from the RF into core 
location and transfer to 400. 
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1 Will read Cold UNIX from the RF into core 
location and transfer to 400. 

2 Will read the una s signed 3K program into 
core location and transfer to 400. 

10 Will dump 1 2K words of memory from core 
location onto DECtape drive 7. 

Will load a standard UNIX binary paper 

tape into core location and transfer to 
0. 

57500 Will load the standard DEC absolute and 
binary loaders and transfer to 57500. 

Thus we come to the UNIX warm boot procedure: put 
173700 into the switches, push load address and 
then push start . The alternate switch setting of 
73700 that will load warm UNIX is used as a sig- 
nal to bring up a single user system for special 
purposes. See / etc / init . 

Cold boots can be accomplished with the Cold UNIX 
program, but they're not. Thus the Cold UNIX 
slot on the RF may have any proyrani desired. 
This slot is, however, used during a cold boot. 
Mount the UNIX INIT DECtape on drive posillSU^ 
tioned in the end-zone. Put 173740 into the 
switches. Push load add ress. Put 1 into the 
switches. Push start . This reads a program 
called vcboot from the tape into core location 
and transfers to it. vcboot then reads 1 6K words 
from the DECtape (blocks 1-32) and copies the 
data to the highest 1 6K words of the RF. Thus 
this initializes the read-only part of the RF. 
vcboot then reads in bos and executes it. bos 
then reads in Cold UNIX and executes that. Cold 
UNIX halts for a last chance before it completely 
initializes the RF file system. Push continue, 
and Cold UNIX will initialize the RF. It then 
sets into execution a user program that reads the 
DECtape for initialization files starting from 
block 33. When this is done, the program exe- 
cutes /etc/init which should have been on the 
tape. 

The INIT tape is made by the program maki running 
under UNIX. maki writes vcboot on block of 
/dev/tap?. It then copies the RF 1 6K words 
(using / dev /rfO) onto blocks 1 thru 32. It has 
internally a list of files to be copied from 
block 33 on. This list follows: 

/etc/init 
/bin/chmod 
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/bin/chown 
/bin/cp 
/bin/In 
/bin/ Is 
/bin/mkdir 

/ Jb^O. 11/ III V 
/ Vv ^ »-i / »-nn 

/bin/rmdir 
/bin/sh 
/bin/ Stat 
/bin/ tap 

Thus this is the set of programs available after 
a cold boot, /etc/init and /bin/sh are mandato- 
ry, /bin/tap and /bin/mkdir are used to load up 
the file system. The rest of the programs are 
frosting. As soon as possible, an sdate should 
be done . 

The last link in this incestuous daisy chain is 
the program msy s. 

msys char file 

will copy the file file onto the RF read only 



o^ou ^^GcXj.xed 



uy 



taken from the following set: 

b bos 

u warm UNIX 

1 Cold UNIX 

2 unassigned 

Due to their rarity of use, maki and msys are 
maintained off line and must be reassembled be- 
fore used. 



FILES 
SEE ALSO 



/dev/rfO, /dev/tapn 

/etc/init, /bin/tap, /bin/sh, /bin/mkdir, bppt 
format 



DIAGNOSTICS 
BUGS 



The files /bin/mount, /bin/sdate, and /bin/date 
should be included in the initialization list of 
maki . 



OWNER 



ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



brti , brt2 — B runtime routines 



The first of these routines must be loaded first 
in an eXeCUtabie B proyram; the SQCoVtu must be 
xuciutsu ±a.s\,f aiuci. ajLJ. uCiici i.uuu->.n<=: 3 • i nSy ajL<- 

not in /etc/bilib only because having them 
separate is the easiest way to assure the order 
of loading. 



b command, bilib 



ken 
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/ETC/F1 , F2, F3, F4 (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



f 1 , f2, f 3 , f4 — Fortran compiler 



These programs represent the four phases of a 
Fortran compilation: 

f1 : specification statements 

f2? common and equivalence allocation 

f 3 : executable statements 

f4: cleanup 

Each exec's the next; the first is called by the 
for command. 

f.tmpi, f.tmp2, f.tmp3 

for 



Besides the fact that there is a good deal of the 
Fortran language missing, there is no for 
comma n 



UWiNiiK 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



glob — global 



glob is used to exgand arguments to the shell 
containing "*" or ?". It is passed the argument 
list containing the metacharacters; glob expands 
the list and calls the command itself. 



sh 

"no match", "no command" 

glob will only load a command from /bin. Also if 
any "*" or "? argument fails to generate 
matches, "no match is typed and the command is 
not executed. 



OWNER 



dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



init — process initialization 



init is invoked inside UNIX as the last step in 
ty*e #300t '^-Tocedviire It '^iirs*' carries ^^'i*** ^^sv'e^a** 

the tape files and the RK disk file to 17, be- 
cause if the system ci'ashed while a ta p ox" rk 
command was in progress, these files would be 
inaccessible; it also truncates the file 
/tmp/utmp, which contains a list of UNIX users, 
again as a recovery measure in case of a crash. 
Directory usr is assigned via sys moun t as 
resident on the RK disk. 



init then forks several times so as to create one 
process for each typewriter channel on which a 
user may log in. Each process changes the mode 
of its typewriter to 1 5 (read/write owner, 
write-only non-owner; this guards against random 
users stealing input) and the owner to the 
super-user. Then the typewriter is opened for 
reading and writing. Since these opens are for 
the first files open in the process, they receive 

and output file descriptors. It is likely that 
no one is dialled in when the read open takes 
place; therefore the process waits until someone 
calls. At this point, init types its "login:" 
message and reads the response, which is looked 
up in the password file. The password file con- 
tains each user's name, password, numerical user 
ID, default working directory, and default shell. 
If the lookup is successful and the user can sup- 
ply his password, the owner of the typewriter is 
changed to the appropriate user ID. An entry is 
made in /tmp/utmp for this user to maintain an 
up-to-date list of users. Then the user ID of 
the process is changed appropriately, the current 
directory is set, and the appropriate program to 
be used as the Shell is executed. 

At some point the process will terminate, either 
because the login was successful but the user has 
now logged out, or because the login was unsuc- 
cessful. The parent routine of all the children 
of init has meanwhile been waiting for such an 
event. When return takes place from the sys 
wait , init simply forks again, and the child pro- 
cess again awaits a user. 

There is a fine point involved in reading the 
login message. UNIX is presently set up to han- 
dle automatically two types of terminals: 150 
baud, full duplex terminals with the line-feed 
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/ETC/ INI T (VII) 



FILES 

SEE ALSO 

DIAGNOSTICS 



function (typically, the Model 37 Teletype termi- 
nal), and 300 baud, full duplex terminals with 
only the line-space function (typically the GE 
TermiNet terminal). The latter type identifies 
itself by sending a line-break (long space) sig- 

the typewriter mode is set to accommodate this 
terminal and the "login:" message is typed again 
(because it was garbled the first time), 

Init, upon first entry, checks the switches for 
73700. If this combination is set, init will 
open /dev/tty as standard input and output and 
directly execute /bin/sh. In this manner, UNIX 
can be brought up with a minimum of hardware and 
software. 

/tmp/utmp, /dev/ttyO ... /dev/ttyn 

sh 



No directory 



No shell 



There are also some 



bal 



if basic I/O files cannot be found in /dev. 



OWNER 



ken , dmr 
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/ETC/KBD (VII) 



NAME 

SYtTOPSIS 

DESCRIPTION 



kbd — keyboard map 

cat /etc/kbd 

kbd contains a map to the keyboard for model 37 
Teletype terminals with the extended character 
set feature. If kbd is printed on such a termi- 
nal, the following will appear; 

< [1 234567890-_] ''X >qwertyuiop@ asdfghjkl; : zxcvbnm,./ 
<V1 234567890— dJ*Y > v ;: ,./ 

<{!"#$%&'() =_}"! >QWERTYUIOP* ASDFGHJKL+* ZXCVBNM,.? 

< !"#$%&'() =- >£AA^9a'cpTen a6 5$r'?JtpX+* n^uuypTiu,.? 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



jfo 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



liba.a — assembly language library 



This library is the standard location for 
assembly-language subroutines of general use. A 
section of this manual is devoted to its con- 
tents. 

This library is^ searched when the link editor Id 
encounters the "-1 argument. 



Id ; library manual 



dmr, Icen 
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NAME libb.a — B library 

SYNOPSIS 

DESCRIPTION This library contains all B-callable subroutines 

wx. sjw.i«j.v-A wiv,j.j.j.i,y , xi_i3 wuiiueiics are aenaixea m 
uiie j.^*^j.«»ij, tacv- k-j-vji* (ji. uue o iiiaiiucix • At present 
its contents are: 

char 

getchr 

putchr 

exit 

printf 

seek 

setuid 

Stat 

time 

unlink 

wait 

Ichar 

chdir 

chmod 

chown 

close 

cr 6a t 

execl 

execv 

fork 

fstat 

getuid 

intr 

link 

makdir 

open 

read 

write 

ctime 

FILES 

SEE ALSO b 

DIAGNOSTICS 

BUGS 

OWNER ken, dmr 
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LIBF.A (VII) 



NAME 



SYNOPSIS 



DESCRIPTION 



/etc/libf.a — Fortran library 



This library contains all tha Frotran runtime 
routines. Many are missing. 



FILES 
SEE ALSO 
DIAGNOSTICS 
BUGS 



■F1 f -> f-i -FA 
— • t — " t — — » — * 



Will be renamed, and libf .a reserved for 
subroutines and functions. 



OWNER 



ken, dmr 
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LOGIN, LOGOUT (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



logging in and logging out 



UNIX must be called from an appropriate terminal. 
The two general classes of terminals which UNIX 
supports are typified by the 37 Teletype on the 
one hand and the GE TermiNet 300 and Memorex 1240 
on the other. The principal difference is the 









carriage return character. Most terminals 
operating at 150, 300, or 1200 baud using the 
ASCII character set either work (more or less) at 
the moment or can be used by special arrangement. 
In particular, special arrangement is necessary 
for terminals which do not generate lower-case 
ASCII characters. 

It is also necessary to have a valid UNIX user ID 
and (if desired) password. These may be ob- 
tained, together with the telephone number, from 
the system administrators. 

The same telephone number serves terminals 
operating at both the standard speeds. When a 
connection is established via a 150-baud terminal 
(e.g. TTY 37) UNIX types out "login:"; you 
respond with your user name, and, if a mask is 
typed, with a^password. If the login was suc- 
cessful, the "§" character is typed by the Shell 
to indicate login is complete and commands may be 
issued. A message of the day may be typed if 
there are anj/' announcements. Also, if there is a 
file called mailbox", you are notified that 



someone has sent you mail, 
mand. ) 



(See the mail com- 



From a 300-baud terminal, the procedure is 
slightly different. Such terminals often have a 
full-duplex switch, which should be turned on (or 
conversely, half-duplex should be turned off) , 
When a connection with UNIX is established, a few 
garbage^^ characters are typed (these are the 

login:" message at the wrong speed). You should 
depress the "break" key; this is a speed- 
independent signal to UNIX that a 300-baud termi- 
nal is in use. It will type "login:" (at the 
correct speed this time) and from then on the 
procedure is the same as described above. 

Logging out is simple by comparison (in fact, 
sometimes too simple) , Simply generate an end- 
of-file at Shell level^^by using the EOT 
character; the "login:" message will appear again 
to indicate that you may log in again. 
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LOGIN, LOGOUT (VIl) 



FILES 

DIAGNOSTICS 
BUGS 



It is also possible to log out simply by hanging 
up the terminal; this simulates an end-of-file on 
the typewriter. 



init 



Hanging up on programs which never read the type- 
writer or which ignore end-of-files is very 
dangerous; in the worst cases, the progreuns can 
only be halted by restarting the system. 



OWN£R 



ken, dmr 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



msh — mini-shell 



msh is a heavily simplified version of the Shell, 
It reads one line .from the standard input file, 
interprets it as a command, and calls the com- 
mand. 

The mini-shell supports few of the advanced 
features of the Shell; none of the following 
characters is special : 

> < $ \ ; & 

However, "*" and "?" are recognized and glob is 
called. The main use of msh is to provide a 
command- executing facility for various interac- 
tive sub- systems. 



sh, glob 



ken, dmr 
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/ETC/SUFTAB (VII) 



NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 
OWNER 



suftab — suffix table 



suftab is a table of suffixes used to guide 
hyphenation in roff . Its first 12 words are not 
used (see a, out format.) Its next 26 words point 
to the beginning of the subtables for each of the 
26 initial letters of a suffix* The first entry 
for each suffix is a count of the number of bytes 
in the suffix. The second byte of each entry is 
a flag indicating the type of suffix. The suffix 
itself follows; the high bits of each letter 
indicate where the hyphens come. The table for 
each initial suffix letter ends with a zero count 
byte. 



roff 



jfo, dmr. Ken 
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NAME 

SYNOPSIS 

DESCRIPTION 



FILES 

SEE ALSO 

DIAGNOSTICS 

BUGS 

OWNER 



tabs — tab stop set 

cat /etc/tabs 

When printed on a suitable terminal, this file 
will set tab stops at columns 8, 16, 24, 32, .... 
Suitable terminals include the Teletype model 37 
and the GE TermiNet 300. 

Since UNIX times delays assuming tabs set every 
8, this has become a defacto 'standard.' 



ken 



